Flow MCP 서버

Flow 블록체인과 상호 작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 AI 어시스턴트는 표준화된 인터페이스를 통해 Flow 블록체인 데이터에 접근하고 작업을 수행할 수 있습니다.

특징

Flow 및 대체 가능 토큰에 대한 잔액 확인
.find 및 .fn 도메인에 대한 도메인 확인
블록체인 데이터를 읽기 위한 스크립트 실행
거래 제출 및 모니터링
계정 정보 검색
환경 변수에 따른 흐름 구성

설치

npx 사용(권장)

지엑스피1

또는 포트와 함께 HTTP 모드를 지정하세요.

npx -y @outblock/flow-mcp-server --port 3000

로컬 설치(개발용)

git clone https://github.com/lmcmz/flow-mcp-server.git
cd flow-mcp-server
npm install
npm run build
npm start

용법

npx로 실행

# Run in stdio mode (for AI assistant integration)
npx -y @outblock/flow-mcp-server --stdio

# Run as HTTP server on port 3000
npx -y @outblock/flow-mcp-server --port 3000

# Specify Flow network
npx -y @outblock/flow-mcp-server --port 3000 --network testnet

로컬 개발 서버 실행

# Run in stdio mode
npm run build
npm start

# Run as HTTP server on port 3000
npm run build
PORT=3000 npm start

# For development with auto-reload
npm run dev

구성

서버는 환경 변수를 사용하여 구성할 수 있습니다.

PORT - 수신할 HTTP 포트(설정하지 않으면 기본적으로 stdio 모드)
FLOW_NETWORK - 연결할 Flow 네트워크(메인넷, 테스트넷, 에뮬레이터)
FLOW_ACCESS_NODE - 사용자 정의 흐름 액세스 노드 URL
LOG_LEVEL - 로깅 수준(디버그, 정보, 경고, 오류)

AI 어시스턴트와 함께 사용

Claude와 같은 AI 어시스턴트와 통합할 때 MCP 서버를 stdio 모드로 시작하고 어시스턴트의 도구 구성에 연결할 수 있습니다.

Claude 도구 구성 예:

{
  "tools": [
    {
      "name": "flow-mcp-server",
      "command": "npx -y @outblock/flow-mcp-server --stdio"
    }
  ]
}

HTTP API 엔드포인트

HTTP 모드에서 실행할 경우 다음 엔드포인트를 사용할 수 있습니다.

/sse - 실시간 업데이트를 위한 서버에서 보낸 이벤트 엔드포인트
/messages - 도구 요청을 보내기 위한 POST 엔드포인트
/health - 상태 확인 엔드포인트
/ - 서버 정보

HTTP API 호출 예:

curl -X POST http://localhost:3000/messages \
  -H "Content-Type: application/json" \
  -d '{
    "tool_request": {
      "name": "get_balance",
      "parameters": {
        "address": "0x2d4c3caffbeab845",
        "network": "mainnet"
      }
    }
  }'

사용 가능한 도구

get_balance - 주소에 대한 Flow 잔액 가져오기
get_token_balance - 대체 가능 토큰 잔액 가져오기
get_account - 계정 정보 가져오기
resolve_domain - .find 또는 .fn 도메인을 주소로 확인합니다.
execute_script - Cadence 스크립트 실행
send_transaction - 블록체인에 거래 보내기
get_transaction - ID로 거래 세부 정보 가져오기

버전 기록

v0.1.1 - 트랜잭션 서비스의 formatArguments 가져오기 문제에 대한 버그 수정
v0.1.0 - 기본 Flow 블록체인 통합을 포함한 초기 릴리스

특허

MIT

Flow MCP Server

Integrations