一个增强型MCP（模型上下文协议）服务器，用于容量系统，实现与知识管理系统的无缝集成。

注： 这是 jemgold/capacities-mcp 的一个分支，增加了更多功能和修复。

与原作的不同之处

新工具：capacities_read_object_content

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

• 先尝试未文档的API端点进行直接检索
• 当无法直接访问时，会退回搜索 API 聚合
• 提供标题参数以提高搜索准确性

特色

该MCP服务器提供访问所有当前Capacities API端点：

• 列表空间 - 获取你所有的个人空间
• 空间信息 - 检索详细的空间结构和收藏
• 搜索内容 - 带高级筛选的跨空间搜索

Capacities MCP Plus

An enhanced MCP (Model Context Protocol) server for Capacities, providing seamless integration with your knowledge management system.

Note: This is a fork of jemgold/capacities-mcp with additional features and fixes.

What’s Different from the Original

New Tool: capacities_read_object_content

Retrieve the full content of any Capacities object by its ID:

• Tries undocumented API endpoints first for direct retrieval
• Falls back to search API aggregation when direct access unavailable
• Provides title parameter to improve search accuracy

Features

This MCP server provides access to all current Capacities API endpoints:

• List Spaces - Get all your personal spaces
• Space Information - Retrieve detailed space structures and collections
• Search Content - Search across spaces with advanced filtering
• Read Object Content - Retrieve full note content by object ID
• Save Weblinks - Save URLs to your spaces with metadata
• Daily Notes - Add content to your daily notes

Installation

For Claude Desktop (macOS)

Add to your Claude Desktop configuration (~/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"
      }
    }
  }
}

For Claude Desktop (Windows)

Windows requires a cmd wrapper. Add to %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"
      }
    }
  }
}

Get your Capacities API key from your Capacities account settings.

That’s it! The server will be automatically downloaded and run when Claude Desktop starts.

Development

Local Setup

For local development, you’ll need to clone and build the project:

1. Clone this repository:

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

2. Install dependencies:

npm install
# or
bun install

3. Copy the example environment file:

cp .env.example .env

4. Add your Capacities API key to .env: