产品介绍

产品定位

这是一个基于MCP协议的天气服务示例项目，主要用于演示如何构建和使用MCP服务器。

核心功能

1. 实现了一个简单的笔记存储系统
2. 使用自定义的note:// URI方案访问单个笔记
3. 每个笔记资源包含名称、描述和text/plain MIME类型
4. 提供笔记摘要生成功能
5. summarize-notes提示：创建所有存储笔记的摘要
6. 可选"style"参数控制详细程度（brief/detailed）
7. 提供笔记添加工具
8. add-note工具：向服务器添加新笔记
9. 需要"name"和"content"作为必需参数
10. 更新服务器状态并通知客户端资源变更

适用场景

1. MCP协议的学习和演示
2. 简单的笔记存储和管理系统
3. 文本内容摘要生成

工具列表

1. add-note工具
2. 能力：向服务器添加新笔记
3. 参数："name"（名称）和"content"（内容）

常见问题解答

1. 调试困难
2. 建议使用MCP Inspector进行调试
3. 可通过npm安装并使用

使用教程

使用依赖

1. 需要安装Claude Desktop
2. MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
3. Windows: %APPDATA%/Claude/claude_desktop_config.json

安装教程

1. 开发/未发布服务器配置

"mcpServers": {
  "weather-service": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/<you-user-name>/Codes/GitHub/weather_service",
      "run",
      "weather-service"
    ]
  }
}

1. 已发布服务器配置

"mcpServers": {
  "weather-service": {
    "command": "uvx",
    "args": [
      "weather-service"
    ]
  }
}

调试方式

1. 使用MCP Inspector进行调试

npx @modelcontextprotocol/inspector uv --directory /Users/<your-user-name>/Codes/GitHub/weather_service run weather-service

1. 构建和发布

uv sync
uv build
uv publish

1. 发布时需要设置PyPI凭证
2. Token: --token 或 UV_PUBLISH_TOKEN
3. 或用户名/密码: --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

许可证

None