Sherlock MCP

🚀 組件

本服務器打造了一個簡易的筆記存儲系統，具備以下特性：

• 自定義的 note:// URI 方案，可用於精準訪問單個筆記。
• 每個筆記資源涵蓋名稱、描述以及 text/plain 標記類型。

✨ 提示語

服務器提供瞭如下提示：

• summarize-notes：能夠生成所有已存儲筆記的摘要。
  • 具備可選的“風格”參數，可用於控制摘要的詳細程度（有簡潔和詳細兩種風格可選）。
  • 會依據風格偏好生成包含所有當前筆記的提示語。

🛠️ 工具

服務器實現了一項實用工具：

• add-note：可向服務器添加新的筆記。
  • 該工具要求接受“名稱”和“內容”作為必需的字符串參數。
  • 會更新服務器狀態，並及時通知客戶端資源發生的變化。

📋 配置

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

🚀 快速開始

📦 安裝

Windows 桌面版

• 在 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 服務器是通過標準輸入輸出運行的，調試工作可能具有一定挑戰性。為了獲取最佳的調試體驗，我們強烈推薦使用 MCP 檢查器。

您可以通過 npm 執行以下命令來啟動 MCP 檢查器：

npx @modelcontextprotocol/inspector uv --directory /Users/pengren/go/github.com/Fewsats/sherlock-mcp run sherlock-mcp

啟動之後，檢查器會在瀏覽器中顯示一個 URL，您可以在該頁面開始調試工作。