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

This server cannot be installed

security - not tested

license - not found

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

RPC 호출을 통해 AI 에이전트가 Flow 블록체인과 상호 작용하고 계정 잔액, 스크립트 실행, 트랜잭션, 도메인 확인 및 계약 상호 작용을 지원할 수 있는 모델 컨텍스트 프로토콜 서버입니다.

Related MCP Servers

EVM MCP Server
mcpdotdirect
A
security
A
license
A
quality
A Model Context Protocol server that enables AI agents to interact with 30+ Ethereum-compatible blockchain networks, providing services like token transfers, contract interactions, and ENS resolution through a unified interface.
Last updated -
28
230
252
TypeScript
MIT License
Flow MCP Server
lmcmz
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants to access Flow blockchain data and perform operations such as checking balances, resolving domains, executing scripts, and submitting transactions.
Last updated -
JavaScript
TON Access MCP Server
aiopinions
-
security
A
license
-
quality
A production-ready Model Context Protocol server implementation that connects AI assistants to the TON blockchain, allowing them to query wallet balances, transaction details, smart contracts, and other blockchain data.
Last updated -
TypeScript
MIT License
Starknet MCP Server
mcpdotdirect
A
security
A
license
A
quality
A comprehensive Model Context Protocol server that enables AI agents to interact with Starknet blockchain, query data, manage wallets, and work with smart contracts.
Last updated -
25
15
4
TypeScript
MIT License

View all related MCP servers

Flow MCP Server