MCP Pinecone

🚀 松果云模型コンテキストプロトコルサーバードキュメント

このプロジェクトは、Claudeデスクトップ用に、松果雲のインデックスを読み書きできるMCP（Model Context Protocol）サーバーを実装します。

🚀 クイックスタート

インストールと実行

1. 以下のコマンドを使用してサーバーをインストールします。

uv add mcp-pinecone@latest

2. プロジェクトディレクトリにconfig.jsonという設定ファイルを作成し、以下の内容を追加します。

{
  "pinecone": {
    "indexName": "YOUR_INDEX_NAME",
    "apiKey": "YOUR_API_KEY"
  }
}

3. サーバーを起動します。

uv run mcp-pinecone

インデックスの作成

以下のコマンドを使用して、新しい松果雲インデックスを作成します。

uv exec mcp-pinecone create-index --name my-index

✨ 主な機能

このMCPサーバーは、Claudeデスクトップと連携し、松果雲のインデックスを読み書きすることができます。

コンポーネント構造

flowchart TB
    subgraph クライアント["MCPクライアント（Claudeデスクトップなど）"]
        UI[ユーザーインターフェース]
    end

    subgraph サーバーコンポーネント["MCPサーバー（pinecone-mcp）"]
        Server[サーバークラス]

        subgraph ハンドラー["リクエストハンドラー"]
            PineconeIndexHandler[松果雲インデックスハンドラー]
            FileHandler[ファイルハンドラー]
        end
    end

    subgraph 松果雲サービス["松果雲サービス"]
        PineconeService[松果雲サービス]
        APIEndpoint[APIエンドポイント]
    end

    UI --> Server
    Server --> PineconeIndexHandler
    PineconeIndexHandler --> PineconeService
    PineconeService --> APIEndpoint

📦 インストール

依存関係の管理とビルド

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

uv sync

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

uv build

3. PyPIに公開します。

uv publish

💻 使用例

基本的な使用法

以下の手順でサーバーをインストール、設定、起動します。

uv add mcp-pinecone@latest

{
  "pinecone": {
    "indexName": "YOUR_INDEX_NAME",
    "apiKey": "YOUR_API_KEY"
  }
}

uv run mcp-pinecone

高度な使用法

新しい松果雲インデックスを作成するには、以下のコマンドを使用します。

uv exec mcp-pinecone create-index --name my-index

🔧 技術詳細

デバッグガイド

MCPサーバーは標準入出力で動作するため、デバッグが難しい場合があります。MCP Inspectorを使用することをおすすめします。

Inspectorをインストールして起動するには、以下のコマンドを実行します。

npx @modelcontextprotocol/inspector uv --directory {project_dir} run mcp-pinecone

📄 ライセンス

このプロジェクトはMITライセンスに準拠しています。詳細はLICENSEファイルを参照してください。

ソースコードの場所

ソースコードはGitHubにホストされています。

貢献とフィードバック

Blueskyを通じて、または問題を提出することで、フィードバックや提案を歓迎します。