Anytype MCP

🚀 任何類型 MCP 服務器

這是一個提供對 Anytype API 訪問的 MCP（模型上下文協議）服務器，允許 AI 助手和其他 MCP 客戶端與您的 Anytype 數據進行交互，為您的數據使用帶來更多便利。

基於 Anytype API 定義 v0.46+ (2025-03-17)。
請確保您的 Anytype 桌面版本與此兼容。

🚀 快速開始

在使用本 MCP 服務器前，請確保滿足以下先決條件：

• Node.js 18 或更高版本
• 正在本地運行的 Anytype 桌面應用程序
• Anytype 賬戶

✨ 主要特性

• 獲取空間列表（get_spaces）
• 在指定空間內搜索/獲取對象（get_objects，search_space）或全局搜索（global_search）
• 獲取對象的詳細內容（get_object_content，支持檢索全文）
• 創建和刪除空間（create_space）和對象（create_object，delete_object）
• 將對象導出為 Markdown 格式（export_object）
• 管理列表視圖和列表中的對象（get_list_views，get_list_view_objects，add_objects_to_list，remove_object_from_list）
• 獲取空間成員（get_space_members）
• 獲取類型和模板（get_types，get_type_details，get_templates，get_template_details）

📦 安裝指南

手動安裝

1. 克隆此倉庫：

git clone https://github.com/Qwinty/anytype-mcp.git
cd anytype-mcp

2. 安裝依賴項：

npm install

3. 構建項目（將 TypeScript 編譯為 JavaScript 到 build/ 目錄）：

npm run build

4. 獲取一個 App Key：在配置服務器之前，您需要從 Anytype 獲取一個 App Key。請參閱下面的“獲取 App Key”部分。
5. 將 MCP 服務器添加到您的 MCP 配置文件中

獲取 App Key

運行 npm run get-key 腳本來獲取一個新的 App Key，並將其更新到您的 MCP 配置中，然後重啟您的 MCP 客戶端。

📚 詳細文檔

Anytype API 不響應

確保 Anytype 桌面應用程序正在運行。MCP 服務器連接到本地 Anytype API 的地址為 http://localhost:31009/v1。

認證問題

如果您遇到認證錯誤：

1. 運行 npm run get-key 來獲取一個新的 App Key
2. 更新您的 MCP 配置文件中的新密鑰
3. 重啟您的 MCP 客戶端

本地 API 端口

默認情況下，服務器連接到 Anytype API 的地址為 http://localhost:31009/v1。如果您的 Anytype 安裝使用了不同的端口，則需要修改 src/index.ts 中的 apiBaseUrl 變量並重新構建（運行 npm run build）。通過環境變量配置此屬性是未來潛在的功能改進。

📄 許可證

MIT