项目简介

Phalcon MCP Server 是一个符合 Model Context Protocol (MCP) 规范的应用后端。它集成了 BlockSec 平台的区块链分析能力,将复杂的区块链交易分析和链信息查询功能封装为可供大型语言模型 (LLM) 客户端调用的工具。

主要功能点

该服务器通过 MCP 协议提供以下主要功能:

  • 交易分析工具: 提供对区块链交易的深度分析,包括:
    • 追踪 (Trace): 查看交易的内部调用流程和 Gas 使用情况。
    • 概览 (Profile): 获取交易的详细信息、资金流向和代币信息。
    • 地址标签 (AddressLabel): 查询合约地址、协议等链上实体的易读标签。
    • 余额变化 (BalanceChange): 获取交易引起的详细余额变动信息。
    • 状态变化 (StateChange): 查看交易对合约存储变量等状态的改变。
    • 交易总览 (TransactionOverview): 聚合所有分析工具的结果,提供交易的全面报告。
  • 链信息工具: 提供查询区块链基本信息的能力:
    • 按名称获取链ID (GetChainIdByName): 根据链的名称、简称或 Slug 查询其对应的链 ID。

安装步骤

该项目使用 Go 语言开发,可以通过 Go 工具链轻松安装:

  1. 确保您已经安装了 Go 编程语言环境(建议使用最新版本)。

  2. 打开终端或命令行界面。

  3. 执行以下命令进行安装:

    go install github.com/mark3labs/phalcon-mcp@latest

安装成功后,'phalcon-mcp' 命令应该就可以在您的系统路径中找到。

服务器配置

Phalcon MCP Server 设计用于被支持 MCP 协议的客户端(如某些 AI 应用或开发工具)调用。客户端需要知道如何启动这个服务器。典型的 MCP 客户端配置会包含一个 JSON 结构来定义服务器,例如:

{
  "mcpServers": {
    "phalcon": { // 服务器的内部名称,可自定义
      "command": "phalcon-mcp", // 启动服务器的可执行命令
      "args": ["serve"] // 传递给命令的参数,"serve" 命令启动 MCP 服务
    }
  }
}

这段配置告诉 MCP 客户端:存在一个名为 "phalcon" 的 MCP 服务器,可以通过执行 'phalcon-mcp serve' 命令来启动它。客户端启动服务器后,会通过标准输入输出 (Stdio) 与服务器进行 JSON-RPC 通信,调用其提供的工具。

基本使用方法

通常情况下,您不需要直接手动运行服务器。当配置了 Phalcon MCP Server 的 MCP 客户端启动时,它会自动执行 'phalcon-mcp serve' 命令来启动服务器并在后台运行。

如果您想手动测试服务器或查看其启动输出,可以在终端执行:

phalcon-mcp serve

这将在当前终端启动服务器,并等待 MCP 客户端通过标准输入发送请求。

信息

分类

开发者工具