os-hub-mcp MCP server

基本能力

产品定位

os-hub-mcp是一个基于MCP协议的笔记存储和管理服务器。

核心功能

1. 实现自定义note:// URI方案访问单个笔记
2. 每个笔记资源包含名称、描述和text/plain MIME类型
3. 提供summarize-notes提示，可创建所有存储笔记的摘要（支持brief/detailed两种详细级别）
4. 提供add-note工具，用于添加新笔记

适用场景

1. 需要集中管理多个笔记的场景
2. 需要自动生成笔记摘要的场景
3. 需要程序化添加和管理笔记的场景

工具列表

1. add-note工具
2. 功能：添加新笔记到服务器
3. 参数：
   • name（必需）：笔记名称
   • content（必需）：笔记内容
4. 效果：更新服务器状态并通知客户端资源变更

常见问题解答

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

使用教程

使用依赖

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

安装教程

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

"mcpServers": {
  "os-hub-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "~/Documents/open-supply-hub-mcp/os-hub-mcp",
      "run",
      "os-hub-mcp"
    ]
  }
}

1. 已发布服务器配置：

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

调试方式

1. 使用MCP Inspector进行调试：

npx @modelcontextprotocol/inspector uv --directory src run os_hub_service

1. 构建和发布：

uv sync
uv build
uv publish

（需要设置PyPI凭证：通过环境变量或命令标志）

许可证

None