金大哥 - sherlock-mcp MCP 详情

article

README

🚀 组件

本服务器打造了一个简易的笔记存储系统，具备以下特性：

自定义的 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

开发/未发布的服务器配置

``` "mcpServers": { "sherlock-mcp": { "command": "uv", "args": [ "--directory", "/Users/pengren/go/github.com/Fewsats/sherlock-mcp", "run", "sherlock-mcp" ] } } ```

已发布的服务器配置

``` "mcpServers": { "sherlock-mcp": { "command": "uvx", "args": [ "sherlock-mcp" ] } } ```

💻 开发

🛠️ 构建和发布

若要准备分发包，可按以下步骤操作：

同步依赖项并更新锁定文件：

uv sync

构建包分布：

uv build

此操作会在 dist/ 目录中创建源代码和轮式发行版。

发布到 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，您可以在该页面开始调试工作。

sherlock-mcp