Phalcon MCP Server

Phalcon MCP サーバー

この MCP サーバーは、BlockSec プラットフォームと連携し、Model Context Protocol（MCP）を通じてブロックチェーンのトランザクション分析ツールを提供します。

Model Context Protocol（MCP）は、AI モデルを統合するためのプロトコルであり、AI モデルが外部のツールやデータソースにアクセスできるようにします。

コンポーネント

ツール

トランザクション分析

• Trace

  • ブロックチェーン上のトランザクションに対する各種呼び出しを、ガス使用量の指標とともに追跡します
  • パラメーター：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)
    }
}

Model Context Protocol での使用

このサーバーを 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