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 文件。