MCP Client And Server

🚀 MCP 客戶端和服務端

模型上下文協議客戶端和服務端的作用是串聯客戶端與服務器，為數據交互和業務邏輯處理搭建橋樑。

✨ 主要特性

資源

服務搭建了一個簡單的筆記存儲系統，具備如下特點：

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

提示語

服務提供了一個實用的提示功能：

• summarize-notes：能夠生成所有存儲筆記的摘要。
  • 支持可選的 "style" 參數，可控制摘要的詳細程度（簡潔/詳細）。
  • 依據風格偏好，生成涵蓋所有當前筆記內容的提示語。

工具

服務實現了一個便捷的工具：

• add-note：可向服務器添加新的筆記。
  • 要求傳入 "name" 和 "content" 作為必填字符串參數。
  • 該工具會更新服務器狀態，並及時通知客戶端資源的更改情況。

📦 安裝指南

用於桌面版 Claude

• 在 MacOS 上：配置文件路徑為 ~/Library/Application\ Support/Claude/claude_desktop_config.json。
• 在 Windows 上：配置文件路徑為 %APPDATA%/Claude/claude_desktop_config.json。

🚀 快速開始

開發

構建和發佈

若要準備分發包，可按以下步驟操作：

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 服務器通過 stdio 運行，調試可能存在一定挑戰。為獲得最佳調試體驗，強烈推薦使用 MCP 檢查器。 您可以通過以下命令啟動 MCP 檢查器（需要先安裝 npm）：

npx @modelcontextprotocol/inspector uv --directory /Users/mlrsmith/Library/Mobile Documents/com~apple~CloudDocs/Family_Shared/AI/mcp/mcp-client-and-server run mcp-client-and-server

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