Nexus MCP

特征

Google 日历集成
- 创建、读取、更新和删除日历事件
- 列出即将发生的事件
黑曜石金库管理
- 创建、阅读、更新和删除笔记
- 笔记中的全文搜索
- 文件夹管理（创建、删除、搜索、列出）
Trello 集成
- 看板、列表和卡片管理
- 创建、更新和删除卡片
- 通过文本查询搜索卡片
网页解析
- 从任何 URL 中提取并清理 HTML 内容
Google 新闻搜索
- 搜索特定主题的最新新闻文章

加入我的Telegram和博客

Related MCP server: VeyraX

先决条件

Python 3.10 或更高版本
Poetry（Python 包管理器）
Google 日历 API 凭据
Trello API 凭证（如果使用 Trello 功能）
Obsidian Vault（如果使用 Obsidian 功能）

安装

克隆存储库：
git clone https://github.com/yourusername/nexus-mcp.git cd nexus-mcp
使用 Poetry 安装依赖项：
poetry install
设置 Google 日历 API：
- 前往Google Cloud Console
- 创建新项目或选择现有项目
- 启用 Google 日历 API
- 创建 OAuth 2.0 凭据
- 下载凭证并将其保存为项目根目录中的credentials.json
设置 Trello API（可选）：
- 前往Trello 开发者门户
- 获取您的 API 密钥和令牌
- 将它们添加到您的环境变量或配置文件中

配置

运行初始设置以通过 Google 日历进行身份验证：
poetry run python main.py
- 这将打开一个浏览器窗口以进行 Google 身份验证
- 按照提示授权应用程序

用法

启动服务器：
poetry run python main.py
服务器将启动并准备接受与 MCP 兼容的客户端连接。
使用任何兼容 MCP 的客户端与服务器交互。服务器提供以下工具：
- 日历管理
- 黑曜石金库运营
- Trello 看板管理
- 网页解析

Anthropic Claude 桌面配置

要将此服务器与 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以启用 Google 日历工具
ENABLE_NEWS_SEARCH ：设置为True以启用 Google 新闻搜索
ENABLE_WEB_PARSER ：设置为True以启用 Web 解析器工具
GOOGLE_CREDENTIALS_PATH ：您的 Google 日历凭据文件 ( credentials.json ) 的路径
GOOGLE_TOKEN_PATH ：您的 Google 日历令牌文件 ( token.json ) 的路径
GOOGLE_API_KEY ：您的 Google API 密钥（用于自定义搜索 API）
GOOGLE_CX_ID ：您的 Google 可编程搜索引擎 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 Vault 的语义搜索
EMBEDDINGS_PATH ：Obsidian Vector Search 插件生成的嵌入 json 文件的可选路径（如果未设置，则默认为相对于OBSIDIAN_VAULT_PATH``.obsidian/plugins/vector-search/data.json ）