Nexus MCP

🚀 Nexus MCP

Nexus MCP 是一個強大的個人助理 MCP 服務器，它集成了包括谷歌日曆、Obsidian 知識庫、Trello 等多種服務，還具備網頁解析能力。該服務器基於 FastMCP 構建，為管理你的數字生活提供了統一的接口。

🚀 快速開始

Nexus MCP 服務器搭建完成後，將為你提供一個集成化的數字生活管理平臺，讓你可以便捷地管理日曆、筆記、Trello 看板等。以下是使用該服務器的基本步驟：

1. 啟動服務器：

poetry run python main.py

2. 連接客戶端：服務器啟動後，即可接受 MCP 兼容客戶端的連接。
3. 使用工具：藉助任何 MCP 兼容客戶端與服務器交互，服務器提供了以下工具：
   • 日曆管理
   • Obsidian 知識庫操作
   • Trello 看板管理
   • 網頁解析

✨ 主要特性

• 谷歌日曆集成
  • 創建、讀取、更新和刪除日曆事件
  • 列出即將到來的事件
• Obsidian 知識庫管理
  • 創建、讀取、更新和刪除筆記
  • 筆記全文搜索
  • 文件夾管理（創建、刪除、搜索、列出）
• Trello 集成
  • 看板、列表和卡片管理
  • 創建、更新和刪除卡片
  • 通過文本查詢搜索卡片
• 網頁解析
  • 從任何 URL 提取並清理 HTML 內容
• 谷歌新聞搜索
  • 搜索給定主題的近期新聞文章

📦 安裝指南

前提條件

• Python 3.10 或更高版本
• Poetry（Python 包管理器）
• 谷歌日曆 API 憑證
• Trello API 憑證（如果使用 Trello 功能）
• Obsidian 知識庫（如果使用 Obsidian 功能）

安裝步驟

1. 克隆倉庫：

git clone https://github.com/yourusername/nexus-mcp.git
cd nexus-mcp

2. 使用 Poetry 安裝依賴：

poetry install

3. 設置谷歌日曆 API：
   • 訪問 谷歌雲控制檯
   • 創建一個新項目或選擇現有項目
   • 啟用谷歌日曆 API
   • 創建 OAuth 2.0 憑證
   • 下載憑證並保存為項目根目錄下的 credentials.json
4. 設置 Trello API（可選）：
   • 訪問 Trello 開發者門戶
   • 獲取你的 API 密鑰和令牌
   • 將它們添加到環境變量或配置文件中

💻 使用示例

基礎用法

啟動服務器：

poetry run python main.py

高級用法

若要將此服務器與 Anthropic Claude Desktop 配合使用，請在你的 Claude Desktop 設置中添加以下配置：

{
   "mcpServers": {
      "personal-assistant": {
         "command": "/path/to/your/venv/bin/python",
         "args": ["/path/to/your/project/main.py"],
         "env": {
                 "GOOGLE_CREDENTIALS_PATH": "/path/to/your/credentials.json",
                 "GOOGLE_TOKEN_PATH": "/path/to/your/token.json",
                 "GOOGLE_API_KEY": "your_google_api_key",
                 "GOOGLE_CX_ID": "your_google_cx_id",
                 "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault",
                 "OBSIDIAN_DEFAULT_FOLDER": "your_default_folder",
                 "TRELLO_API_KEY": "your_trello_api_key",
                 "TRELLO_TOKEN": "your_trello_token",
                 "LOG_PATH": "/path/to/log.txt",
                 "ENABLE_OBSIDIAN_TOOLS": "True/False",
                 "ENABLE_TRELLO_TOOLS": "True/False",
                 "ENABLE_CALENDAR_TOOLS": "True/False",
                 "ENABLE_NEWS_SEARCH": "True/False",
                 "ENABLE_WEB_PARSER": "True/False",
                 "SEMANTIC_SEARCH_ENABLED": "True/False",
                 "EMBEDDINGS_PATH": "/path/to/embeddings.json"
         }
      }
   }
}

請將路徑和憑證替換為你自己的實際值：

• command：Python 虛擬環境的 Python 可執行文件路徑
• args：項目的 main.py 文件路徑
• ENABLE_OBSIDIAN_TOOLS：設置為 True 以啟用 Obsidian 工具
• ENABLE_TRELLO_TOOLS：設置為 True 以啟用 Trello 工具
• ENABLE_CALENDAR_TOOLS：設置為 True 以啟用谷歌日曆工具
• ENABLE_NEWS_SEARCH：設置為 True 以啟用谷歌新聞搜索
• ENABLE_WEB_PARSER：設置為 True 以啟用網頁解析工具
• GOOGLE_CREDENTIALS_PATH：谷歌日曆憑證文件（credentials.json）的路徑
• GOOGLE_TOKEN_PATH：谷歌日曆令牌文件（token.json）的路徑
• GOOGLE_API_KEY：你的谷歌 API 密鑰（用於自定義搜索 API）
• GOOGLE_CX_ID：你的谷歌可編程搜索引擎 ID（自定義搜索 API 的 CX ID）
• OBSIDIAN_VAULT_PATH：Obsidian 知識庫的路徑
• OBSIDIAN_DEFAULT_FOLDER：可選，知識庫中創建新筆記的默認文件夾路徑
• TRELLO_API_KEY：你的 Trello API 密鑰
• TRELLO_TOKEN：你的 Trello API 令牌
• LOG_PATH：日誌文件的路徑
• SEMANTIC_SEARCH_ENABLED：設置為 True 以啟用 Obsidian 知識庫的語義搜索
• SIMILARITY_TRESHOLD：默認值為 0.5，這是語義搜索的閾值
• EMBEDDINGS_PATH：可選，Obsidian 向量搜索插件生成的嵌入 JSON 文件的路徑（如果未設置，默認為相對於 OBSIDIAN_VAULT_PATH 的 .obsidian/plugins/vector-search/data.json）
• MODEL_TOKEN_LIMIT：AI 模型理解筆記分塊的限制
• CHUNK_SIZE_TOKENS：分塊大小

若要啟用語義搜索功能，你需要為 Obsidian 安裝 向量搜索插件。 重新索引過程完成後，插件將在以下位置生成一個包含向量嵌入的 JSON 文件：

.obsidian/plugins/vector-search/data.json

該文件將作為語義搜索查詢的嵌入源。

📚 詳細文檔

推薦客戶端

• Anthropic Claude Desktop
• 5ire

開發相關

• 項目使用 Poetry 進行依賴管理。
• 所有工具都在 main.py 中註冊。
• 特定服務的實現位於 services/ 目錄中。
• Python 代碼遵循 PEP 8 風格指南。

貢獻指南

1. 分叉倉庫。
2. 創建你的功能分支（git checkout -b feature/amazing-feature）。
3. 提交你的更改（git commit -m 'Add some amazing feature'）。
4. 推送到該分支（git push origin feature/amazing-feature）。
5. 打開一個拉取請求。

同時，你可以加入 Telegram 和 博客 與開發者交流。