MCP Server Opensearch

🚀 MCP 服務器 OpenSearch 版本

這是一個基於 MCP 協議的簡單服務器項目，實現了筆記存儲系統，提供提示語句和工具，可方便地管理筆記資源。

🚀 快速開始

📦 安裝指南

使用 Claude Desktop

在 MacOS 上：~/Library/Application\ Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json%

✨ 主要特性

🔍 資源

該服務器實現了一個簡單的筆記存儲系統，具備以下功能：

• 自定義 note:// URI 方案，可用於訪問單個筆記。
• 每個筆記資源包含名稱、描述和 text/plain MIME 類型。

💬 提示語句

該服務器提供一個提示語句：

• summarize-notes：創建所有存儲筆記的摘要。
  • 可選“風格”參數來控制詳細程度（簡潔/詳細）。
  • 根據風格偏好生成包含所有當前筆記內容的提示語句。

🛠️ 工具

該服務器實現了一個工具：

• add-note：向服務器添加新的筆記。
  • 接受“名稱”和“內容”作為必填字符串參數。
  • 更新服務器狀態並通知客戶端資源更改。

🔧 技術細節

構建和發佈

為了準備分發包，可按以下步驟操作：

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

uv sync

2. 構建包分發版本：

uv build

這將在 dist/ 目錄下創建源代碼和 wheel 分發版本。

3. 發佈到 PyPI：

uv publish

⚠️ 重要提示

發佈到 PyPI 時，您需要通過環境變量或命令行參數設置 PyPI 憑證：

• 令牌：--token 或 UV_PUBLISH_TOKEN
• 或者用戶名/密碼：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

調試

由於 MCP 服務器通過標準輸入輸出運行，調試可能會比較困難。為了獲得最佳的調試體驗，我們強烈推薦使用 MCP Inspector。

您可以通過以下命令啟動 MCP Inspector（假設已安裝 npm）：

npx @modelcontextprotocol/inspector uv --directory /Users/gowtham/Gowtham/Projects/mcp-server-opensearch run mcp-server-opensearch

啟動後，Inspector 會顯示一個 URL，您可以在瀏覽器中訪問該 URL 開始調試。