Capacities Mcp Plus

Capacities MCP Plus

这是一个增强版的 MCP（模型上下文协议）服务，适用于 Capacities，可与您的知识管理系统无缝集成。

注意： 这是 jemgold/capacities-mcp 的分支版本，增加了更多功能并修复了一些问题。

与原版的区别

功能	原版	Plus
读取对象内容	不支持	按对象 ID 获取完整笔记内容
fastmcp 版本	1.27.3	3.25.4（修复了 MCP SDK 兼容性问题）
Windows 支持	可能存在问题	已使用 cmd 封装器进行测试
npm 包	capacities-mcp	capacities-mcp-plus

新工具：capacities_read_object_content

按 ID 获取任意 Capacities 对象的完整内容：

• 优先尝试未公开的 API 端点，直接获取内容
• 无法直接访问时，回退到搜索 API 聚合结果
• 提供标题参数以提高搜索准确性

功能

此 MCP 服务可访问 Capacities 当前提供的所有 API 端点：

• 列出空间 - 获取您的所有个人空间
• 空间信息 - 获取详细的空间结构和集合信息
• 搜索内容 - 使用高级筛选条件搜索各个空间
• 读取对象内容 - 按对象 ID 获取完整笔记内容
• 保存网页链接 - 将 URL 连同元数据保存到您的空间
• 每日笔记 - 向每日笔记添加内容

安装

用于 Claude Desktop（macOS）

将以下内容添加到您的 Claude Desktop 配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "capacities": {
      "command": "npx",
      "args": ["-y", "capacities-mcp-plus"],
      "env": {
        "CAPACITIES_API_KEY": "your_capacities_api_key_here"
      }
    }
  }
}

用于 Claude Desktop（Windows）

Windows 需要使用 cmd 封装器。将以下内容添加到 %APPDATA%\Claude\claude_desktop_config.json：

{
  "mcpServers": {
    "capacities": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "capacities-mcp-plus"],
      "env": {
        "CAPACITIES_API_KEY": "your_capacities_api_key_here"
      }
    }
  }
}

从您的 Capacities 账户设置中获取 Capacities API 密钥。

完成！Claude Desktop 启动时将自动下载并运行此服务。

开发

本地设置

进行本地开发时，您需要克隆并构建项目：

1. 克隆此仓库：

git clone https://github.com/Im-Hal-9K/capacities-mcp.git
cd capacities-mcp

2. 安装依赖项：

npm install
# or
bun install

3. 复制示例环境文件：

cp .env.example .env

4. 将您的 Capacities API 密钥添加到 .env：

CAPACITIES_API_KEY=your_api_key_here

5. 构建服务：

npm run build

运行服务

以交互模式启动开发服务：

bun run dev

用于生产环境：

npm run start

检查服务工具和架构：

bun run inspect

测试

运行测试套件：

bun run test

代码质量

检查代码规范和类型：

bun run lint

格式化代码：

bun run format

API 参考

从您的 Capacities 账户设置中获取 Capacities API 密钥。

详细的 API 文档请参阅：

• Capacities API 文档
• OpenAPI 架构

可用工具

capacities_list_spaces

获取您的所有个人空间列表。

capacities_get_space_info

获取特定空间的详细信息，包括结构和集合。

• spaceId：空间的 UUID

capacities_search

使用可选筛选条件搜索各个空间中的内容。

• searchTerm：要搜索的文本
• spaceIds：要搜索的空间 UUID 数组
• mode（可选）：搜索模式，可选 "fullText" 或 "title"
• filterStructureIds（可选）：按特定结构类型筛选

capacities_read_object_content

通过 Capacities 对象的 ID 获取其完整内容。

• objectId：要获取的对象的 UUID（可在 Capacities 中通过“复制对象引用”获取）
• spaceId：包含该对象的空间的 UUID
• title（可选）：对象的标题或部分标题——强烈建议提供，以改善搜索结果
• 工作原理：
  1. 首先尝试使用未公开的 GET 端点直接获取对象
  2. 如果失败，则回退到搜索 API，汇总高亮内容和摘要片段
  3. 按对象 ID 筛选搜索结果，以找到完全匹配的结果
• 注意：使用搜索回退时，内容可能不完整，因为内容是由搜索摘要片段拼合而成的。提供 title 参数可显著改善结果。

capacities_save_weblink

将网页链接保存到空间，并可选择添加元数据。

• spaceId：目标空间的 UUID
• url：要保存的 URL
• titleOverwrite（可选）：链接的自定义标题
• descriptionOverwrite（可选）：描述文本
• tags（可选）：标签数组。标签必须与 Capacities 中的标签名称完全匹配，否则将新建标签。
• mdText（可选）：采用 Markdown 格式的文本，将添加到笔记部分

capacities_save_to_daily_note

将 Markdown 内容添加到空间中今天的每日笔记。

• spaceId：目标空间的 UUID
• mdText：要添加的 Markdown 内容
• origin（可选）：内容的来源标签（仅支持 "commandPalette"）
• noTimestamp（可选）：如果为 true，则不会在笔记中添加时间戳

速率限制

Capacities API 的速率限制如下：

• /spaces：每 60 秒 5 次请求
• /space-info：每 60 秒 5 次请求
• /search：每 60 秒 120 次请求
• /save-weblink：每 60 秒 10 次请求
• /save-to-daily-note：每 60 秒 5 次请求

提示词示例

配置此 MCP 服务后，可以在 Claude 中使用以下提示词示例：

入门

"Show me all my Capacities spaces"
"What spaces do I have in Capacities?"

探索知识库

"Get detailed information about my main workspace in Capacities"
"What structures and collections are in my [space name] space?"

搜索内容

"Search for 'project management' across all my Capacities spaces"
"Find all notes mentioning 'machine learning' in my research space"
"Search for 'meeting notes' but only check titles, not full content"

阅读内容

"Read the content of object [object-id] from my research space"
"Get the full note content for [title] in my workspace"

保存信息

"Save this article to my research space: https://example.com/article"
"Bookmark this GitHub repo in my coding space with tags 'javascript' and 'tools'"
"Save this link with a custom title and description to my resources space"

每日笔记

"Add a summary of today's key insights to my daily note"
"Save these meeting notes to today's daily note in my work space"
"Add this quote to my daily note: [your quote here]"

高级用法

"Search for 'productivity' in my work and personal spaces, but filter to only show task-related structures"
"Save this research paper to my academic space and add it to today's daily note as well"
"Find all my notes about 'AI tools' and then save the best ones as bookmarks"

致谢

• 原项目由 Jem Gold 开发
• 由 Im-Hal-9K 增强

许可证

MIT——详情请参阅 LICENSE 文件。