Mcpcalculator

🚀 MCP 計算機

Go言語で実装されたモデルコンテキストプロトコル（MCP）サーバーで、計算機と挨拶機能を備えています。この実装は公式のMCP仕様に準拠しています。

✨ 主な機能

• 完全なJSON - RPC 2.0の実装
• MCPプロトコルのサポート
• ツールの登録と実行
• リソースの処理
• サーバー機能の協議
• 仕様に基づくエラー処理

📚 ドキュメント

プロジェクト構造

mcpcalculator/
├── mcp/
│   └── protocol/
│       ├── types.go    # プロトコルの型と構造
│       ├── server.go   # MCPサーバーの実装
│       └── client.go   # MCPクライアントの実装
├── main.go            # サンプルの使い方
├── go.mod             # Goモジュールファイル
└── README.md          # ドキュメント

必要条件

• Go 1.21以上

📦 インストール

git clone https://github.com/akhidasTech/mcpcalculator.git
cd mcpcalculator
go mod download

💻 使用例

サーバーの起動

go run main.go

サーバーは8080ポートで起動します。

リクエストの送信

ツールとリソースはJSON - RPC 2.0仕様に従います。

ツールの追加

curl -X POST http://localhost:8080 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "add",
    "params": {"a": 5, "b": 3}
  }'

リソースへの挨拶

curl -X POST http://localhost:8080 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "greeting",
    "params": {"name": "John"}
  }'

レスポンス形式

すべてのレスポンスはJSON - RPC 2.0形式に従います。

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": <結果値>
}

またはエラーの場合：

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": <エラーコード>,
        "message": "エラーメッセージ",
        "data": <追加データ>
    }
}

🔧 技術詳細

プロトコルの実装

この実装はモデルコンテキストプロトコル仕様に従っています。

1. JSON - RPC 2.0：すべての通信にJSON - RPC 2.0プロトコルを使用します。
2. 機能：サーバーは初期化時にその機能を宣言します。
3. ツール：ツールの登録と実行プロトコルを実装しています。
4. リソース：リソースアクセスプロトコルを実装しています。
5. エラー処理：標準のエラーコードと形式を使用します。

セキュリティ

この実装はMCPセキュリティガイドラインに従っています。

1. ユーザーの同意：ツールとリソースは明示的な呼び出しが必要です。
2. データのプライバシー：明示的なリクエストがない限り、データは共有されません。
3. ツールのセキュリティ：ツールの実行は制御され、検証されます。
4. エラー処理：正しいエラー報告と処理が行われます。

🤝 貢献

貢献を歓迎します！自由にPull Requestを送信してください。