Personal Assistant MCP

🚀 神經元 MCP 服務器

這是一個強大的多功能個人助手服務器，集成了 Google Calendar、Obsidian Vault、Trello 等多種服務，還具備網頁解析功能，能為用戶提供高效便捷的服務體驗。

🚀 快速開始

神經元 MCP 服務器是一款集成多種服務的多功能個人助手服務器。使用前，需確保滿足先決條件並完成安裝配置。

✨ 主要特性

集成服務

• Google 日曆：可管理和同步日曆事件，讓日程安排井井有條。
• Obsidian 保險庫：提供語義搜索功能，支持向量檢索（需安裝 Vector Search 插件），方便用戶快速查找信息。
• Trello：能處理看板任務和進行項目管理，助力高效協作。
• 網頁解析器：可從指定 URL 提取並解析網頁內容，滿足信息獲取需求。

核心特性

• 模塊化設計：各服務獨立運行，便於維護和擴展，提高系統的靈活性和穩定性。
• 語義搜索：基於上下文理解進行智能查詢，提升搜索的準確性和效率。
• 日誌記錄：記錄操作日誌，方便排查問題，保障系統的正常運行。

📦 安裝指南

先決條件

• 操作系統：推薦使用 Linux 或 macOS 系統，Windows 環境可能需要額外配置。
• Python 版本：必須安裝 Python 3.8 或更高版本。
• 依賴管理工具：安裝 Poetry 用於包管理。

安裝步驟

1. 克隆代碼倉庫：

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

2. 安裝依賴項：

poetry install

3. 配置環境變量：

• 創建並編輯 .env 文件，填寫對應的 API 憑證和路徑信息。

4. 啟動服務：

poetry run start

📚 詳細文檔

配置指南

環境變量配置示例（適用於 Anthropic Claude Desktop）

# 示例 .env 文件內容
GOOGLE_CREDENTIALS_PATH=/path/to/credentials.json
GOOGLE_TOKEN_PATH=/path/to/token.json
GOOGLE_API_KEY=your_api_key_here
GOOGLE_CX_ID=your_cx_id_here

OBSIDIAN_VAULT_PATH=/path/to/obsidian vault
OBSIDIAN_DEFAULT_FOLDER=/path/to/default folder
TRELLO_API_KEY=your_trello_api_key
TRELLO_TOKEN=your_trello_token
LOG_PATH=/path/to/logfile.log
SEMANTIC_SEARCH_ENABLED=True
SIMILARITY_THRESHOLD=0.5
EMBEDDINGS_PATH=/path/to/embeddings.json
MODEL_TOKEN_LIMIT=4096
CHUNK_SIZE_TOKENS=1024

向量搜索插件

為了啟用語義搜索功能，需在 Obsidian 中安裝並配置 Vector Search 插件。完成插件設置後，會生成一個嵌入文件位於 .obsidian/plugins/vector-search/data.json。

推薦客戶端

• Anthropic Claude Desktop
• 5ire

開發指南

項目結構

• poetry：用於依賴管理。
• main.py：註冊所有工具和服務的主入口點。
• services/：各服務的具體實現模塊。

貢獻流程

1. Fork 代碼倉庫。
2. 創建功能分支：

git checkout -b feature/your-feature-name

3. 提交更改並推送至遠程倉庫：

git commit -m '添加或改進某項功能'
git push origin feature/your-feature-name

4. 提交 Pull Request。

圖片示例