@outblock/flow-mcp

Инструменты блокчейна Flow для Model Context Protocol (MCP). Этот пакет предоставляет набор инструментов для взаимодействия с блокчейном Flow через Model Context Protocol.

Функции

• Получите баланс FLOW для любого адреса

• Получить баланс токенов для любого токена Flow

• Получить информацию об учетной записи COA

• Получить исходный код контракта

• Получите подробную информацию об учетной записи, включая статистику хранилища

Related MCP server: MCP Etherscan Server

Установка

# Using npm
npm install @outblock/flow-mcp

# Using bun
bun add @outblock/flow-mcp

Конфигурация МКП

Чтобы использовать этот инструмент с Клодом, добавьте следующее в конфигурацию MCP:

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

Конфигурацию MCP можно найти здесь:

• macOS: ~/Library/Application Support/Claude/mcp.json

• Windows: %APPDATA%/Claude/mcp.json

• Linux: ~/.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

Чтобы добавить сервер MCP для разработки в Claude Desktop:

1. Создайте проект:

   bun run build

2. Добавьте в конфигурацию 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>

Это позволит:

1. Создайте новый каталог инструментов в src/tools/<tool-name>

2. Сгенерируйте базовую структуру инструмента, включая:

   • index.ts (основная реализация)

   • schema.ts (схема JSON для параметров инструмента)

   • test.ts (тестовый файл)

3. Обновите файл индекса инструментов, чтобы экспортировать новый инструмент.

Пример:

bun run scripts/create-tool.ts weather

Формат сообщения о фиксации

• feat : Новая функция (увеличивает младшую версию)

• fix : исправление ошибки (версия исправления ошибок)

• BREAKING CHANGE : Критическое изменение (увеличивает основную версию)

📜 Управление версиями

Этот проект использует standard-version для автоматизированного управления версиями. Запустите bun run release для создания новой версии.

📦 Публикация в npm

1. Убедитесь, что вы вошли в npm:

   npm login

2. Создайте проект:

   bun run build

3. Опубликовать пакет:

   npm publish

Не забудьте обновить номер версии с помощью bun run release перед публикацией новых версий.

Лицензия

Лицензия MIT — подробности см. в разделе ЛИЦЕНЗИЯ.

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.