Flow MCP 서버

직접 RPC 통신을 사용하는 Flow 블록체인을 위한 MCP(Model Context Protocol) 서버입니다.

이 서버는 모델 컨텍스트 프로토콜을 구현하고 RPC 호출을 통해 Flow 블록체인과 직접 상호 작용할 수 있는 도구를 제공합니다.

특징

계정 잔액(FLOW 및 토큰) 가져오기
흐름 스크립트 실행
거래 보내기
도메인을 Flow 주소로 확인
Flow 계약과 상호 작용
AI 에이전트 통합을 위한 완전한 MCP 준수

설정

저장소를 복제합니다.지엑스피1
종속성 설치:
# Using npm npm install # Using Bun (recommended) bun install
(선택 사항) 구성을 사용하여 .env 파일을 만듭니다.
PORT=3000 FLOW_NETWORK=testnet # Optional: defaults to 'mainnet' if not specified
서버는 기본적으로 Flow 메인넷을 사용합니다. 테스트넷이나 사용자 지정 포트를 사용하려는 경우에만 환경을 구성하면 됩니다.

용법

서버 시작

# Run in development mode with hot reload
bun dev

# Run in production mode
bun start

# Build the server
bun run build

NPX 명령 사용

설치 없이 npx를 사용하여 MCP 서버를 직접 실행할 수 있습니다.

# Run using npx
npx flow-mcp-server

# Specify network and port
npx flow-mcp-server --network testnet --port 3001

# Get help for all options
npx flow-mcp-server --help

또는 전역적으로 설치하세요.

# Install globally
npm install -g flow-mcp-server

# Run the globally installed version
flow-mcp-server

명령줄 옵션

Options:
  -p, --port <port>          Port to run the server on (default: 3000)
  -n, --network <network>    Flow network to connect to (default: mainnet)
  -a, --access-node <url>    Custom Flow access node URL
  --stdio                    Run in stdio mode for direct integration
  -h, --help                 Show this help text

네트워크 구성

서버는 선택한 네트워크에 적합한 계약 주소로 FCL을 자동으로 구성합니다. 지원되는 네트워크는 다음과 같습니다.

메인넷

메인넷 구성에는 다음에 대한 계약 주소가 포함됩니다.

{
  NonFungibleToken: '0x1d7e57aa55817448',
  FungibleToken: '0xf233dcee88fe0abe',
  MetadataViews: '0x1d7e57aa55817448',
  NFTCatalog: '0x49a7cda3a1eecc29',
  NFTRetrieval: '0x49a7cda3a1eecc29',
  Find: '0x097bafa4e0b48eef',
  Flowns: '0x233eb012d34b0070',
  Domains: '0x233eb012d34b0070',
  FlowToken: '0x1654653399040a61',
  TransactionGeneration: '0xe52522745adf5c34',
  FlowFees: '0xf919ee77447b7497',
  StringUtils: '0xa340dc0a4ec828ab',
  HybridCustody: '0xd8a7e05a7ac670c0',
  ViewResolver: '0x1d7e57aa55817448'
}

테스트넷

테스트넷 구성에는 테스트넷 환경에 대한 계약 주소가 포함되어 있습니다.

/networks 엔드포인트에 액세스하면 현재 네트워크 구성을 볼 수도 있습니다.

MCP 구성

AI 어시스턴트가 Flow MCP를 사용하도록 구성하려면 다음 구성을 사용하세요.

{
  "mcpServers": {
    "flow-mcp": {
      "command": "npx",
      "args": ["-y", "flow-mcp-server", "--stdio"],
      "env": {
        "FLOW_NETWORK": "mainnet"  // Optional: defaults to 'mainnet', can be set to 'testnet'
      }
    }
  }
}

또는 직접 HTTP API를 사용하면:

{
  "mcpServers": {
    "flow-mcp": {
      "serverUrl": "http://localhost:3000",
      "env": {
        "FLOW_NETWORK": "mainnet"
      }
    }
  }
}

AI 어시스턴트 활용

이 서버는 MCP(Model Context Protocol)를 구현하여 MCP를 지원하는 AI 어시스턴트와 함께 사용할 수 있도록 합니다. 또한, Flow 블록체인과 상호 작용하기 위한 다양한 도구를 제공합니다.

API 엔드포인트

/sse - 실시간 통신을 위한 SSE 엔드포인트
/messages - 도구 요청을 보내기 위한 엔드포인트
/health - 상태 확인 엔드포인트
/ - 서버 정보
/networks - 네트워크 구성 정보

사용 가능한 도구

get_flow_balance - 주소에 대한 FLOW 잔액을 가져옵니다.
get_token_balance - 주소에 대한 토큰 잔액을 가져옵니다.
execute_script - Cadence 스크립트 실행
send_transaction - 서명된 트랜잭션을 Flow 블록체인으로 보냅니다.
resolve_domain - .find 또는 .fn 도메인을 Flow 주소로 확인합니다.

npm에 게시하기

이 패키지의 자체 버전을 게시하려면 다음을 수행하세요.

# Login to npm
npm login

# Publish the package
npm publish

# Update the package
npm version patch  # or minor or major
npm publish

특허

MIT

Flow MCP Server

Integrations