mcp-server MCP server

基本能力

产品定位

mcp-server 是一个基础的 MCP 服务器，主要用于实现简单的笔记存储和管理功能。

核心功能

1. 笔记存储系统：
2. 实现自定义的 note:// URI 方案来访问单个笔记

3. 每个笔记资源包含名称、描述和文本/纯文本 MIME 类型

4. 提示功能：

5. summarize-notes：创建所有存储笔记的摘要

   • 可选的 "style" 参数控制详细程度（brief/detailed）
   • 生成结合所有当前笔记和风格偏好的提示

6. 工具功能：

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

适用场景

1. 需要简单笔记存储和管理的应用
2. 需要自动生成笔记摘要的场景
3. 需要集成笔记添加功能的开发环境

工具列表

1. add-note：
2. 能力：向服务器添加新笔记
3. 参数：需要 "name" 和 "content" 作为必需的字符串参数
4. 效果：更新服务器状态并通知客户端资源更改

常见问题解答

1. 调试困难：
2. 由于 MCP 服务器通过 stdio 运行，调试可能具有挑战性
3. 推荐使用 MCP Inspector 进行调试

使用教程

使用依赖

无明确前置依赖要求。

安装教程

Claude Desktop

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

开发/未发布服务器配置

"mcpServers": {
  "mcp-server": {
    "command": "uv",
    "args": [
      "--directory",
      "C:\Users\marti\Documents\Github\MyGithub\mcp-server",
      "run",
      "mcp-server"
    ]
  }
}

已发布服务器配置

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

构建和发布

1. 同步依赖并更新锁文件：

uv sync

1. 构建包分发：

uv build

1. 发布到 PyPI：

uv publish

调试方式

使用 MCP Inspector 进行调试：

npx @modelcontextprotocol/inspector uv --directory C:\Users\marti\Documents\Github\MyGithub\mcp-server run mcp-server

许可证

None