Phalcon MCP Server

Phalcon MCP 服务

此 MCP 服务与 BlockSec 平台集成，通过模型上下文协议（MCP）提供区块链交易分析工具。

模型上下文协议（MCP）是一种用于 AI 模型集成的协议，可让 AI 模型访问外部工具和数据源。

组件

工具

交易分析

• Trace

  • 跟踪区块链上交易的不同调用及其 Gas 使用指标
  • 参数：chainId（必填）、transactionHash（必填）

• Profile

  • 分析区块链上的交易，提供交易详情、资金流向和代币信息
  • 参数：chainId（必填）、transactionHash（必填）

• AddressLabel

  • 获取合约地址的人类可读标签，例如代币、协议和其他链上实体的标签
  • 参数：chainId（必填）、transactionHash（必填）

• BalanceChange

  • 获取交易的详细余额变化信息
  • 参数：chainId（必填）、transactionHash（必填）

• StateChange

  • 获取交易的详细状态变化信息，例如合约中的存储变量变化
  • 参数：chainId（必填）、transactionHash（必填）

• TransactionOverview

  • 汇总所有可用分析工具的数据，全面概览一笔交易
  • 参数：chainId（必填）、transactionHash（必填）

链信息

• GetChainIdByName
  • 根据名称、链或 chainSlug 获取区块链的链 ID
  • 参数：name（必填）

快速开始

安装

使用 Go Install

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

使用方法

启动 MCP 服务：

phalcon-mcp serve

查看版本：

phalcon-mcp version

作为包使用

你可以在 Go 项目中导入此服务：

Stdio 模式

import "github.com/mark3labs/phalcon-mcp/server"

func main() {
    // Create a new server with version
    s := server.NewServer("1.0.0")
    
    // Start the server in stdio mode
    if err := s.ServeStdio(); err != nil {
        log.Fatalf("Server error: %v", err)
    }
}

进程内模式

使用 mcp-go 客户端库进行进程内调用：

import (
    "context"
    "log"
    
    "github.com/mark3labs/mcp-go/client"
    "github.com/mark3labs/mcp-go/client/transport"
    "github.com/mark3labs/phalcon-mcp/server"
)

func main() {
    // Create the Phalcon MCP server
    phalconServer := server.NewServer("1.0.0")

    // Create an in-process transport using the server's MCPServer
    inProcessTransport := transport.NewInProcessTransport(phalconServer.GetMCPServer())

    // Create an MCP client using the in-process transport
    mcpClient := client.NewMCPClient(inProcessTransport)

    // Start the transport
    ctx := context.Background()
    if err := mcpClient.Connect(ctx); err != nil {
        log.Fatalf("Failed to connect: %v", err)
    }
    defer mcpClient.Close()

    // Initialize the client
    if err := mcpClient.Initialize(ctx); err != nil {
        log.Fatalf("Failed to initialize: %v", err)
    }

    // List available tools
    tools, err := mcpClient.ListTools(ctx)
    if err != nil {
        log.Fatalf("Failed to list tools: %v", err)
    }

    // Use the tools...
    result, err := mcpClient.CallTool(ctx, "get-chain-id-by-name", map[string]any{
        "name": "ethereum",
    })
    if err != nil {
        log.Fatalf("Failed to call tool: %v", err)
    }
}

与模型上下文协议搭配使用

要将此服务集成到支持 MCP 的应用中：

{
  "mcpServers": {
    "phalcon": {
      "command": "phalcon-mcp",
      "args": ["serve"]
    }
  }
}

Docker

使用 Docker 运行

你可以使用 Docker 运行 Phalcon MCP 服务：

docker run -i --rm ghcr.io/mark3labs/phalcon-mcp:latest serve

使用 MCP 配置 Docker

要将 Docker 镜像集成到支持 MCP 的应用中：

{
  "mcpServers": {
    "phalcon": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/mark3labs/phalcon-mcp:latest",
        "serve"
      ]
    }
  }
}

许可证

MIT