Capacities MCP

🚀 Capacities MCP服务器

Capacities MCP服务器是一个专为 Capacities 打造的模型上下文协议（MCP）服务器，可实现与您的知识管理系统的无缝集成。

✨ 主要特性

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

• 列出空间 - 获取您的所有个人空间
• 空间信息 - 获取详细的空间结构和集合
• 搜索内容 - 通过高级过滤功能在各个空间中进行搜索
• 保存网页链接 - 将带有元数据的URL保存到您的空间中
• 每日笔记 - 向您的每日笔记中添加内容

📦 安装指南

适用于Claude桌面版

将Capacities MCP服务器添加到您的Claude桌面版配置中（在macOS上的路径为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

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

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

就是这么简单！当Claude桌面版启动时，服务器将自动下载并运行。

📚 详细文档

本地开发设置

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

1. 克隆此仓库：

git clone https://github.com/jemgold/capacities-mcp.git
cd capacities-mcp

2. 安装依赖项：

bun install

3. 复制示例环境文件：

cp .env.example .env

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

CAPACITIES_API_KEY=your_api_key_here

5. 构建服务器：

bun run build

运行服务器

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

bun run dev

用于生产环境：

bun 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_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次请求

💻 使用示例

入门示例

"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"

保存信息

"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"

📄 许可证

本项目采用MIT许可证，详情请参阅 LICENSE 文件。