Model Context Protocol (mcp) Server Filesystem Implementation

🚀 モデルコンテキストプロトコル（MCP）サーバ - ファイルシステム実装

このプロジェクトは、Go言語とEchoフレームワークを使用して実装された教育目的のモデルコンテキストプロトコル（MCP）サーバです。このサーバは、MCPプロトコルを通じてローカルファイルシステムへのアクセスを提供します。

🚀 クイックスタート

モデルコンテキストプロトコル（MCP）は、データソースとAIツール間の通信のための安全な双方向接続を構築するためのオープン標準です。この実装では、ローカルファイルシステムへのアクセスを提供するMCPサーバの作成方法を示しています。

✨ 主な機能

• ファイルシステムプロバイダ：MCPツールとリソースを通じてローカルファイルシステムへのアクセスを提供します。
• ツール：
  • filesystem.list：ディレクトリの内容をリストします。
  • filesystem.read：ファイルの内容を読み取ります。
  • filesystem.write：ファイルに内容を書き込みます。
  • filesystem.delete：ファイルまたはディレクトリを削除します。
• リソース：
  • filesystem.file：ファイルシステム内のファイルを表します。
  • filesystem.directory：ファイルシステム内のディレクトリを表します。

🔧 技術詳細

この実装には基本的なパスクリーニング機能が含まれており、ディレクトリトラバーサル攻撃を防止しますが、教育目的のみで使用されます。本番環境では、以下のような追加のセキュリティ対策が必要です。

• ユーザー認証と承認
• より強力な入力検証
• レート制限
• 監査ログ記録
• 隔離サンドボックス

📦 インストール

前提条件

• Go 1.24以上

インストール手順

1. リポジトリをクローンします。
2. 依存関係をインストールします：go mod tidy
3. サーバを起動します：go run main.go

サーバはデフォルトで8080ポートで起動します。PORT環境変数を設定することでポートを変更できます。

📚 ドキュメント

API エンドポイント

• GET /：サーバ情報を取得します。
• POST /v1/discover：サーバの機能を検出します。
• POST /v1/call-tool：ツールを呼び出します。
• POST /v1/load-resource：リソースをロードします。

💻 使用例

サーバの機能を検出する

curl -X POST http://localhost:8080/v1/discover

ディレクトリの内容をリストする

curl -X POST http://localhost:8080/v1/call-tool \
  -H "Content-Type: application/json" \
  -d '{
    "tool_id": "filesystem.list",
    "request_id": "req-123",
    "params": {
      "arguments": {
        "path": "."
      }
    }
  }'

ファイルの内容を読み取る

curl -X POST http://localhost:8080/v1/call-tool \
  -H "Content-Type: application/json" \
  -d '{
    "tool_id": "filesystem.read",
    "request_id": "req-123",