MCP Pinecone

🚀 松果雲模型上下文協議服務器文檔

本項目為Claude桌面實現了一個能夠讀取和寫入松果雲索引的MCP（Model Context Protocol）服務器，為Claude桌面與松果雲索引的數據交互提供了支持。

🚀 快速開始

安裝與運行

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

✨ 主要特性

本項目實現了為Claude桌面讀取和寫入松果雲索引的功能，通過構建MCP服務器，實現了客戶端與松果雲服務之間的數據交互。

🔧 技術細節

組件結構

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

該圖展示了項目的組件結構，包括MCP客戶端、MCP服務器和松果雲服務。客戶端通過用戶界面與服務器交互，服務器包含服務器類和請求處理器，請求處理器中的松果雲索引處理器負責與松果雲服務進行數據交互，最終通過API端點完成操作。

📦 安裝指南

依賴管理與構建

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

📚 詳細文檔

項目開發

依賴管理與構建

1. 同步依賴項並更新鎖文件：

uv sync

2. 構建發行版本：

uv build

3. 發佈到PyPI：

uv publish

調試指南

由於MCP服務器通過標準輸入輸出運行，調試較為困難。推薦使用MCP Inspector進行調試。

安裝Inspector並啟動：

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

📄 許可證

本項目遵循MIT許可證，具體內容請參閱LICENSE文件。

🔗 其他信息

源代碼地址

源代碼託管在GitHub。

貢獻與反饋

歡迎通過Bluesky或提交問題的方式提供反饋和建議。