MCP GITHUB SERVER

🚀 MCP-GITHUB-SERVER 服務器

MCP-GITHUB-SERVER 服務器實現了一個簡單的筆記存儲系統，支持自定義 URI 方案訪問筆記，還提供生成筆記摘要和添加新筆記等功能，方便用戶對筆記進行管理和操作。

🚀 快速開始

安裝

Claude 桌面版

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

✨ 主要特性

資源

• 該服務器實現了一個簡單的筆記存儲系統，具備以下功能：
  • 支持自定義 note:// URI 方案，可用於訪問單個筆記。
  • 每個筆記資源包含名稱、描述和 text/plain MIME 類型。

提示語句

• 服務器提供一個提示語句 summarize-notes，用於生成所有存儲筆記的摘要。
  • 支持可選的 "style" 參數來控制詳細程度（簡要/詳細）。
  • 可根據風格偏好生成包含所有當前筆記內容的提示語。

工具

• 服務器實現了一個工具 add-note，用於向服務器添加新的筆記。
  • 該工具接受 "name" 和 "content" 作為必需字符串參數。
  • 會更新服務器狀態並通知客戶端資源更改。

🔧 技術細節

構建與發佈

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

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

uv sync

2. 構建發行版：

uv build

這將在 dist/ 目錄下生成源代碼和輪文件（wheel）。 3. 發佈到 PyPI：

uv publish

注意：你需要通過環境變量或命令行參數設置 PyPI 憑證：

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

調試

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

你可以通過以下命令啟動 MCP 檢查器：

npx @modelcontextprotocol/inspector uv --directory C:\Users\DELL\Desktop\mcp-github-server\MCP-GITHUB-SERVER run mcp-github-server

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