Jtorreggiani Test Python MCP Server

🚀 測試服務器 MCP 服務器

本項目是一個 MCP 服務器，實現了簡單的筆記存儲系統，具備自定義 URI 方案訪問筆記、生成筆記摘要、添加新筆記等功能，為筆記管理提供了便捷的解決方案。

🚀 快速開始

📦 安裝

Claude Desktop

在不同操作系統上，配置文件的路徑如下：

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

✨ 主要特性

🔍 資源

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

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

💡 提示

該服務器提供一個提示功能：

• summarize-notes：生成所有存儲筆記的摘要。
  • 支持可選的“風格”參數，用於控制詳細程度（簡要/詳細）。
  • 可根據風格偏好生成所有當前筆記的提示組合。

🛠️ 工具

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

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

📚 詳細文檔

🔧 構建和發佈

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

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 Inspector。

你可以通過 npm 執行以下命令啟動 MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory /Users/jtorreggiani/organizer/work/open-source/create-python-server/test-server run test-server

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

📄 配置

[待辦：添加特定於你實現的配置詳細信息]