关键词

个人助理日历管理笔记管理任务管理网页抓取新闻搜索

项目简介

Nexus MCP是一个基于Model Context Protocol (MCP) 构建的服务器，旨在作为您的大型语言模型（如Anthropic Claude Desktop）的个人助理后端。它聚合了多种在线服务和本地应用的能力，使您的AI能够访问和操作您的个人数据和工具。

主要功能

该服务器提供以下能力供连接的AI客户端调用：

  • Google Calendar: 创建、列出、更新、删除日历事件。
  • Obsidian Vault: 管理笔记（创建、读、写、删、搜索）和文件夹（创建、删、搜、列）。支持基于内容的简单搜索和可选的语义搜索。
  • Trello: 管理看板、列表和卡片（创建、读、写、删、搜）。
  • 网页解析: 从指定URL提取并清理网页文本内容。
  • Google新闻搜索: 搜索最新新闻文章。

安装步骤

  1. 克隆代码仓库： 
    git clone https://github.com/lemannrus/nexus-mcp.git
cd nexus-mcp
  2. 使用Poetry安装Python依赖： 
    poetry install
  3. 根据需要设置Google Calendar、Trello等服务的API凭据。您通常需要访问各服务的开发者控制台获取API密钥、Token或下载凭据文件。请将凭据文件（如Google Calendar的'credentials.json'）保存在项目目录或指定路径。
  4. 运行首次设置命令（如 'poetry run python main.py'）。对于Google Calendar，这将引导您完成浏览器中的OAuth授权流程，并生成一个token文件，用于后续认证。

服务器配置 (供MCP客户端使用)

要将此Nexus MCP服务器与您的AI客户端连接，您需要在客户端的MCP服务器配置界面添加一条新的服务器记录。典型的配置需要指定如何启动此服务器程序。配置项通常包括：

  • 服务器名称 (server name): 您为此服务器实例自定义的名称（例如 'personal-assistant'）。
  • 启动命令 (command): 服务器程序的执行路径。通常是您为项目创建的Python虚拟环境中的 'python' 解释器完整路径（例如 '/home/youruser/.cache/pypoetry/virtualenvs/nexus-mcp-xxxxxx/bin/python'）。
  • 启动参数 (args): 传递给启动命令的参数列表。对于此项目，通常是 'main.py' 脚本的完整路径（例如 '/home/youruser/nexus-mcp/main.py'）。
  • 环境变量 (env): 用于配置服务器连接到各种服务所需的凭据、路径和功能启停设置。您需要在此处设置如 'GOOGLE_CREDENTIALS_PATH' (Google凭据文件路径)、'GOOGLE_TOKEN_PATH' (Google token文件路径)、'TRELLO_API_KEY'、'TRELLO_TOKEN'、'OBSIDIAN_VAULT_PATH' (Obsidian库路径) 等变量，并根据需求设置 'ENABLE_OBSIDIAN_TOOLS'、'ENABLE_TRELLO_TOOLS' 等布尔值变量来启用或禁用特定功能。请参照项目的README获取完整的环境变量列表及其详细说明，并根据您的实际情况填写。

请注意，具体的配置界面和格式可能因MCP客户端而异，但核心思想是告诉客户端如何启动 'main.py' 脚本以及运行它所需的配置信息。

基本使用方法

完成安装和在AI客户端中配置好Nexus MCP服务器后，启动您的AI客户端。客户端会根据您的配置自动尝试启动或连接到Nexus MCP服务器（通常通过Stdio协议通信）。一旦连接成功，您的AI就能够通过调用服务器注册的工具（如 'create_event', 'read_note', 'search_cards' 等）来执行日历管理、笔记操作、Trello任务处理、网页内容获取和新闻搜索等功能。您可以通过与AI对话的方式，指示它利用这些工具完成任务。

信息

分类

生产力应用

访问项目