이것이 새로운 v3 MCP 서버입니다. 이전 v2+ MCP 서버는 deprecated이며 dataforseo/mcp-server-typescript-deprecated에 저장되어 있습니다.

LLM 에이전트가 DataForSEO API 문서를 탐색하고 인증된 API 요청을 할 수 있도록 MCP 서버와 CLI를 제공합니다. 기본적으로 바이너리는 stdio에서 MCP 서버를 시작합니다; CLI 명령어는 선택 사항인 두 번째 모드입니다.

퀵 스타트

stdio에서 MCP 서버를 시작하세요 (기본 모드; 설정: DATAFORSEO_LOGIN / DATAFORSEO_PASSWORD):

HTTP 전송(포트 3000; PORT로 오버라이드):

인증

OAuth 2.0 (HTTP MCP 기본값): 기본적으로 작동합니다. MCP 클라이언트는 Protected Resource 메타데이터를 통해 DataForSEO 인증 서버를 발견하고 Authorization: Bearer 토큰을 보냅니다.

Fallback: 환경 변수를 통한 API 로그인/비밀번호(HTTP Basic). CLI 및 표준 MCP에 필수; HTTP에서는 Authorization 헤더가 없을 때 사용됩니다.

DATAFORSEO_USERNAME는 DATAFORSEO_LOGIN의 별칭으로 받아들여집니다. API 키를 [[T7]에서 받아보세요.

MCP 서버

동일한 도구 구현이 MCP 서버와 CLI 모두를 구동합니다. 하나의 바이너리가 두 모드를 모두 지원합니다; MCP가 기본값입니다.

이진법이 모드를 선택하는 방법:

DataForSEO MCP Server

This is the new v3 MCP server. The previous v2+ MCP server is deprecated and lives at dataforseo/mcp-server-typescript-deprecated.

MCP server and CLI for LLM agents to browse DataForSEO API documentation and make authenticated API requests. By default the binary starts an MCP server on stdio; CLI commands are an optional second mode.

Quick Start

Start the MCP server on stdio (default mode; set DATAFORSEO_LOGIN / DATAFORSEO_PASSWORD):

npx dataforseo-mcp-server@latest

HTTP transport (port 3000; override with PORT):

npx dataforseo-mcp-server@latest --mode http

Authentication

OAuth 2.0 (default for HTTP MCP): works out of the box. MCP clients discover the DataForSEO authorization server via Protected Resource metadata and send Authorization: Bearer tokens.

Fallback: API login/password via environment variables (HTTP Basic). Required for CLI and stdio MCP; on HTTP it is used when no Authorization header is present.

# bash / macOS / Linux
export DATAFORSEO_LOGIN="your_api_login"
export DATAFORSEO_PASSWORD="your_api_password"

# PowerShell
$env:DATAFORSEO_LOGIN="your_api_login"
$env:DATAFORSEO_PASSWORD="your_api_password"

REM CMD
set DATAFORSEO_LOGIN=your_api_login
set DATAFORSEO_PASSWORD=your_api_password

DATAFORSEO_USERNAME is accepted as an alias for DATAFORSEO_LOGIN. Get API keys at https://app.dataforseo.com/api-access.

MCP Server

The same tool implementations power both the MCP server and the CLI. One binary serves both modes; MCP is the default.

How the binary chooses a mode:

• MCP stdio — default when no CLI command is passed
• MCP HTTP — pass --mode http (Streamable HTTP on port 3000; override with PORT)
• CLI — when the first command is docs or request, or when --cli / --help / --version is passed

MCP stdio (default):

npx dataforseo-mcp-server

MCP HTTP:

npx dataforseo-mcp-server --mode http

CLI:

npx dataforseo-mcp-server docs index

MCP client config (Cursor, Claude Desktop, and similar clients that use mcpServers):

Via URL — use the hosted remote MCP server, or start a local HTTP server (npx dataforseo-mcp-server --mode http) and point the client at it. OAuth works out of the box; env credentials are optional fallback only.

Public remote MCP server URL: https://mcp.dataforseo.com/v3/mcp

{
  "mcpServers": {
    "dataforseo": {
      "url": "https://mcp.dataforseo.com/v3/mcp"
    }
  }
}

Local server (default port 3000):

{
  "mcpServers": {
    "dataforseo": {
      "url": "http://localhost:3000/mcp"
    }
  }
}