Sample MCP Server S3

🚀 S3 モデルコンテキストプロトコルサーバーのサンプル

このプロジェクトは、S3 からデータ（例えば PDF ファイル）を取得するための MCP サーバーの実装です。S3 からのデータ取得を通じて、LLM のコンテキストに情報を効率的にロードすることができます。

✨ 主な機能

リソース

リソース を通じて AWS S3 のデータを表示します。（GET エンドポイントに似ており、LLM のコンテキストに情報をロードするために使用されます）。現在は PDF ファイルのみをサポートし、最大 1000 個のオブジェクトを表示します。

ツール

• ListBuckets
  • 認証されたリクエスト送信者が所有するすべてのバケットのリストを返します。
• ListObjectsV2
  • 特定のバケット内の一部またはすべての（リクエストごとに最大 1000 個）オブジェクトを返します。
• GetObject
  • Amazon S3 からオブジェクトを取得します。GetObject リクエストでは、オブジェクトの完全なキー名を指定します。汎用バケットをサポートしており、仮想ホストスタイルのリクエストとパススタイルのリクエストの両方をサポートします。

📦 インストール

AWS クレデンシャルの設定

1. AWS 管理コンソールを通じて AWS アクセスキー ID、シークレットアクセスキー、およびリージョンを取得し、 デフォルト の設定ファイルを使用してクレデンシャルファイルを設定します。詳細は こちら を参照してください。
2. これらのクレデンシャルが S3 を読み書きするための適切な権限を持っていることを確認してください。

Claude Desktop との連携

Windows と MacOS

• MacOS: ~/Library/Application\ 支持/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json%

{
  "mcpServers": {
    "s3-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/user/generative_ai/model_context_protocol/s3-mcp-server",
        "run",
        "s3-mcp-server"
      ]
    }
  }
}

{
  "mcpServers": {
    "s3-mcp-server": {
      "command": "uvx",
      "args": [
        "s3-mcp-server"
      ]
    }
  }
}

💻 使用例

基本的な使用法

ビルドと公開

分发包を準備するには、以下の手順に従います。

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

2. リリースバージョンをビルドします。

uv build

これにより、dist/ ディレクトリにソースコードとバイナリパッケージが作成されます。

3. PyPI に公開します。

uv publish

注意: PyPI のクレデンシャルを環境変数またはコマンドライン引数で設定する必要があります。

• トークン: --token または UV_PUBLISH_TOKEN
• またはユーザー名/パスワード: --username / UV_PUBLISH_USERNAME と --password / UV_PUBLISH_PASSWORD

高度な使用法

デバッグ

MCP サーバーは標準入出力を介して動作するため、デバッグは困難な場合があります。最適なデバッグ体験を得るために、MCP インスペクター の使用を強くおすすめします。

以下のコマンドを使用して、MCP インスペクターを起動できます。

npx @modelcontextprotocol/inspector uv --directory /Users/user/generative_ai/model_context_protocol/s3-mcp-server run s3-mcp-server

起動後、インスペクターは URL を表示します。この URL をブラウザで開くと、デバッグを開始できます。

🔧 セキュリティ

詳細については、CONTRIBUTING を参照してください。

📄 ライセンス

MIT License

すべての権利を保有します。完全なライセンス情報をご確認ください。