🧩 组件

📚 资源

此服务器实现了简单的笔记保存系统：

• 使用自定义 note:// URI 方案访问单个笔记
• 每个笔记资源具有名称、描述和 text/plain MIME 类型

💡 提示语句

该服务器提供一个单一的提示语句：

• summarize-notes：生成所有当前笔记的摘要
  • 可选的 "style" 参数控制详细程度（brief/detailed）
  • 结合所有当前笔记和样式设置生成提示语句

🛠️ 工具

该服务器实现了一个工具：

• add-note：向服务器添加新的笔记
  • 接收必须的字符串参数 "name" 和 "content"
  • 更新服务器状态并通知客户端资源更改

🚀 快速入门指南

📥 安装

Claude Desktop

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 C:\Prj\weather_service run weather-service

启动时，检查器会在浏览器中显示一个可访问的 URL，开始调试。