Github Issue MCP Server

🚀 GitHub 服務器 MCP 服務端

這是一個基於 TypeScript 的 MCP 服務器，構建了一個簡單的筆記系統。它通過資源管理、工具操作和提示生成等功能，生動地演示了核心的 MCP 概念，為用戶提供便捷的筆記管理體驗。

🚀 快速開始

開發步驟

1. 安裝依賴：

npm install

2. 構建服務器：

npm run build

3. 帶有自動重建功能的開發：

npm run watch

安裝步驟

若要與 Claude Desktop 一起使用，需添加服務器配置：

• MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "github-server": {
      "command": "/path/to/github-server/build/index.js"
    }
  }
}

調試建議

由於 MCP 服務器通過 stdio 進行通信，調試可能頗具挑戰。我們推薦使用 MCP Inspector，它作為包腳本可用：

npm run inspector

Inspector 將提供一個訪問瀏覽器中的調試工具的 URL。

✨ 主要特性

資源

• 通過 note:// URI 列出和訪問筆記。
• 每個筆記具有標題、內容和元數據。
• 使用簡單的純文本 MIME 類型進行內容訪問。

工具

• create_note - 創建新的文本筆記：
  • 接受標題和內容作為必填參數。
  • 在服務器狀態中存儲筆記。

提示

• summarize_notes - 生成所有存儲筆記的摘要：
  • 包括所有筆記內容作為嵌入資源。
  • 返回結構化的提示以供 LLM 進行摘要。

📦 安裝指南

要與 Claude Desktop 一起使用，請按以下步驟添加服務器配置：

1. 確定配置文件路徑：
   • 在 MacOS 上，配置文件路徑為 ~/Library/Application Support/Claude/claude_desktop_config.json。
   • 在 Windows 上，配置文件路徑為 %APPDATA%/Claude/claude_desktop_config.json。
2. 編輯配置文件：

{
  "mcpServers": {
    "github-server": {
      "command": "/path/to/github-server/build/index.js"
    }
  }
}

調試說明

由於 MCP 服務器通過 stdio 進行通信，調試可能會有挑戰。我們推薦使用 MCP Inspector，它作為包腳本可用：

npm run inspector

Inspector 將提供一個訪問瀏覽器中的調試工具的 URL。

💻 使用示例

基礎用法

創建新筆記

# 假設已經完成開發和安裝步驟，可調用 create_note 工具創建新筆記
# 這裡只是示意，實際調用需根據具體環境
# 調用 create_note 工具，傳入標題和內容
# 例如，標題為 "Test Note"，內容為 "This is a test note."
# 具體調用方式可能因實際情況而異

生成筆記摘要

# 調用 summarize_notes 工具生成所有存儲筆記的摘要
# 同樣，具體調用方式需根據實際情況確定

高級用法

結合 MCP Inspector 調試

# 當需要調試 MCP 服務器時，可使用 MCP Inspector
npm run inspector
# Inspector 將提供一個訪問瀏覽器中的調試工具的 URL，通過該 URL 可進行詳細調試