blockscout-mcp-server

Blockscout REST API를 통해 AI 에이전트에게 멀티체인 EVM 온체인 데이터(주소, 트랜잭션, 블록, 로그, 토큰, NFT, 컨트랙트 소스)를 제공하는 읽기 전용 stdio MCP 서버입니다.

[!IMPORTANT] 이는 공식 Blockscout MCP 서버가 아닙니다. 개인 개발자가 유지 관리하는 맞춤형 독립 서버이며, Blockscout 팀과 제휴하거나 보증하지 않습니다.

빠른 시작

npx가 게시된 패키지를 다운로드하여 실행합니다. 수동으로 설치할 것이 없습니다. 모든 프로젝트에서 작동하며, CHAINS_FILE을 해당 프로젝트의 체인 파일로 지정하세요(상대 경로 ./chains.json은 클라이언트의 작업 디렉터리를 기준으로 해석됩니다).

{
  "mcpServers": {
    "blockscout": {
      "command": "npx",
      "args": ["-y", "blockscout-mcp-server"],
      "env": {
        "CHAINS_FILE": "./chains.json",
        "ONLY_CHAINS_FILE": "true"
      }
    }
  }
}

체인 레지스트리와 환경 변수는 시작 시 한 번만 읽힙니다. 구성이나 코드를 변경한 후에는 MCP 클라이언트에서 서버를 재시작(다시 연결)하세요. 바로 편집할 수 있는 .mcp.example.json이 포함되어 있습니다.

Related MCP server: Onesource MCP

지원 체인

이 체인들은 번들 스냅샷(src/chains/bundled.json)에서 기본으로 등록되어 있어 구성이 필요 없습니다. 모든 도구의 chain 인자는 이름(ethereum) 또는 숫자 체인 ID(1)를 허용합니다.

실행 중인 서버에 실제로 등록된 체인을 보려면 get_chains_list 도구를 호출하세요.

사용자 정의 체인

CHAINS_FILE을 추가 체인(또는 번들 체인을 재정의하는 체인)을 설명하는 JSON 파일로 지정하세요. 각 항목에는 name, chainId, Blockscout 인스턴스 url이 필요합니다.

[
  { "name": "my-l2", "chainId": 42, "url": "https://scan.my-l2.io" }
]

CHAINS_FILE이 설정되었지만 파일이 없거나 잘못된 형식이면 서버는 즉시 종료됩니다(fail-fast).

ONLY_CHAINS_FILE=true로 설정하면 CHAINS_FILE의 체인만 등록하고 번들 스냅샷을 완전히 제외합니다. 이 경우 CHAINS_FILE이 설정되어 있어야 합니다(그렇지 않으면 체인이 없어 서버가 빠르게 실패합니다). 기본값(false)은 번들 체인과 CHAINS_FILE을 병합합니다.

로컬 개발

MCP Inspector가 dev dependency로 연결되어 있어, 서버를 실제 클라이언트에 연결하지 않고도 MCP 핸드셰이크를 진행하고 도구를 직접 호출할 수 있습니다.

git clone https://github.com/imelon2/blockscout-mcp-server.git
cd blockscout-mcp-server
pnpm install
pnpm run inspect

pnpm run inspect는 먼저 빌드한 다음 Inspector UI를 엽니다. stdio 전송을 선택하고 node dist/index.js를 지정하세요. 두 가지 바로 가기가 있습니다:

라이선스

MIT