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。

图片示例