@outblock/flow-mcp

모델 컨텍스트 프로토콜(MCP)을 위한 플로우 블록체인 도구입니다. 이 패키지는 모델 컨텍스트 프로토콜을 통해 플로우 블록체인과 상호 작용하기 위한 도구 세트를 제공합니다.

특징

모든 주소에 대한 FLOW 잔액을 받으세요
모든 Flow 토큰에 대한 토큰 잔액을 얻으세요
COA 계정 정보 받기
계약 소스 코드 가져오기
저장 통계를 포함한 자세한 계정 정보를 얻으세요

설치

지엑스피1

MCP 구성

Claude와 함께 이 도구를 사용하려면 MCP 구성에 다음을 추가하세요.

{
  "mcpServers": {
    "flow": {
      "command": "npx",
      "args": ["-y", "@outblock/flow-mcp", "start"]
    }
  }
}

MCP 구성은 다음에서 확인할 수 있습니다.

macOS: ~/Library/Application Support/Claude/mcp.json
윈도우: %APPDATA%/Claude/mcp.json
리눅스: ~/.config/Claude/mcp.json

구성을 추가한 후 Claude를 다시 시작하여 새 MCP 서버를 로드합니다.

도구

흐름 균형

모든 주소에 대한 FLOW 잔액을 확인하세요:

{
  name: 'get_flow_balance',
  input: {
    address: string,
    network?: 'mainnet' | 'testnet'
  }
}

계정 정보

자세한 계정 정보를 확인하세요:

{
  name: 'get_account_info',
  input: {
    address: string,
    network?: 'mainnet' | 'testnet'
  }
}

토큰 잔액

Flow 토큰에 대한 잔액을 얻으세요:

{
  name: 'get_token_balance',
  input: {
    address: string,
    network?: 'mainnet' | 'testnet'
  }
}

COA 계정

COA 계정 정보 받기:

{
  name: 'get_coa_account',
  input: {
    address: string,
    network?: 'mainnet' | 'testnet'
  }
}

계약 받기

계약 소스 코드 받기:

{
  name: 'get_contract',
  input: {
    address: string,
    contractName: string,
    network?: 'mainnet' | 'testnet'
  }
}

📂 프로젝트 구조

flow-mcp/
├── src/
│   ├── tools/          # MCP tools implementation
│   │   ├── flowBalance/    # Flow balance tool
│   │   ├── accountInfo/    # Account info tool
│   │   ├── tokenBalance/   # Token balance tool
│   │   ├── coaAccount/     # COA account tool
│   │   └── getContract/    # Contract source tool
│   ├── utils/          # Shared utilities
│   ├── prompts/        # MCP prompts
│   ├── types/          # Type definitions
│   └── bin/           # CLI implementation
├── biome.json         # Linting configuration
├── tsconfig.json      # TypeScript configuration
└── package.json       # Project dependencies

🛠️ 개발

이 프로젝트에서는 개발 및 테스트에 FastMCP를 사용합니다. FastMCP는 MCP 서버에 간소화된 개발 환경을 제공합니다.

# Install dependencies
bun install

# Format code
bun run format

# Run tests
bun test

# Run development server
bun run dev

# Inspect the server
bun run inspect

# Build
bun run build

Claude Desktop에 개발 MCP 서버를 추가하려면:

프로젝트를 빌드하세요:
bun run build
Claude Desktop 구성에 다음을 추가합니다.
// You only need the argument if you need to pass arguments to your server { "mcpServers": { "your-server-name": { "command": "node", "args": ["/path/to/your/project/dist/main.js", "some_argument"] } } }

새로운 도구 만들기

이 프로젝트에는 새로운 MCP 도구를 만드는 데 도움이 되는 스크립트가 포함되어 있습니다.

bun run scripts/create-tool.ts <tool-name>

이렇게 하면:

src/tools/<tool-name> 아래에 새 도구 디렉토리를 만듭니다.
다음을 포함한 기본 도구 구조를 생성합니다.
- index.ts(주요 구현)
- schema.ts(도구 매개변수에 대한 JSON 스키마)
- test.ts(테스트 파일)
새 도구를 내보내려면 도구 인덱스 파일을 업데이트하세요.

예:

bun run scripts/create-tool.ts weather

커밋 메시지 형식

feat : 새로운 기능(부 버전 추가)
fix : 버그 수정(범프 패치 버전)
BREAKING CHANGE : 주요 변경 사항(주요 버전 변경)

📜 버전 관리

이 프로젝트에서는 자동화된 버전 관리를 위해 standard-version을 사용합니다. bun run release 실행하여 새 버전을 생성하세요.

📦 npm에 게시

npm에 로그인했는지 확인하세요.
npm login
프로젝트를 빌드하세요:
bun run build
패키지를 게시합니다.
npm publish

새로운 버전을 게시하기 전에 bun run release 사용하여 버전 번호를 업데이트하는 것을 잊지 마세요.

특허

MIT 라이센스 - 자세한 내용은 라이센스를 참조하세요.

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

Flow MCP

Integrations