使用说明

项目简介

Personal Assistant MCP Server 是一个基于 Model Context Protocol (MCP) 构建的个人助理服务器。它使用 FastMCP 框架开发，旨在为大型语言模型（LLM）客户端提供丰富的上下文信息和实用工具，帮助用户更好地管理个人数字生活。该服务器集成了多种常用服务，包括 Google 日历、Obsidian 笔记库、Trello 项目管理以及网页内容解析，通过统一的 MCP 接口对外提供服务。

主要功能点

日历管理：集成 Google 日历，支持创建、读取、更新和删除日历事件，以及列出即将发生的事件。
笔记管理：集成 Obsidian 笔记库，支持创建、读取、更新和删除笔记，进行全文搜索，以及管理文件夹（创建、删除、搜索、列表）。
任务管理：集成 Trello，支持看板、列表和卡片管理，可以创建、更新和删除卡片，并按文本查询搜索卡片。
网页解析：能够从任意 URL 中提取和清理 HTML 内容，方便 LLM 理解网页信息。

安装步骤

克隆仓库

git clone https://github.com/lemannrus/personal-assistant-mcp.git
cd personal-assistant-mcp

安装依赖 确保已安装 Python 3.10 或更高版本和 Poetry。然后运行：
```
poetry install
```
配置 Google Calendar API
- 访问 Google Cloud Console 创建或选择现有项目。
- 启用 Google Calendar API。
- 创建 OAuth 2.0 凭据，下载凭据 JSON 文件并保存为项目根目录下的 'credentials.json'。
配置 Trello API (可选)
- 访问 Trello Developer Portal 获取 API 密钥和令牌。
- 将 API 密钥和令牌添加到环境变量或配置文件中。
运行初始设置 首次运行需要进行 Google 日历身份验证：
```
poetry run python main.py
```
按照提示在浏览器中完成 Google 身份验证。

服务器配置

MCP 客户端需要配置服务器的启动命令和参数才能连接。以下是 Claude Desktop 的配置示例，其他 MCP 客户端配置方式类似。

{
   "mcpServers": {
      "personal-assistant": {
         "command": "/path/to/your/venv/bin/python",  // Python 虚拟环境中的 Python 可执行文件路径
         "args": ["/path/to/your/project/main.py"],   // 项目 main.py 文件的路径
         "env": {
                 "CREDENTIALS_PATH": "/path/to/your/credentials.json", // Google Calendar 凭据文件路径
                 "TOKEN_PATH": "/path/to/your/token.json",       // Google Calendar 令牌文件路径
                 "VAULT_PATH": "/path/to/your/obsidian/vault",    // Obsidian 笔记库路径
                 "TRELLO_TOKEN": "your_trello_token",           // 你的 Trello API 令牌
                 "TRELLO_API_KEY": "your_trello_api_key"        // 你的 Trello API 密钥
         }
      }
   }
}

请根据实际安装路径和 API 凭据信息修改上述配置。 关键参数包括 'command'（Python 路径）、'args'（'main.py' 路径）以及 'env' 中的各项 API 密钥和文件路径。

基本使用方法

启动服务器

poetry run python main.py

服务器启动后，即可接受 MCP 客户端的连接。

连接 MCP 客户端 配置 MCP 客户端（如 Claude Desktop）连接到该服务器。客户端会列出服务器提供的工具。
使用工具 通过 MCP 客户端调用服务器提供的工具，例如：
- 使用日历工具管理 Google 日历事件。
- 使用 Obsidian 工具管理本地笔记库。
- 使用 Trello 工具管理 Trello 项目和任务。
- 使用网页解析工具获取网页内容。

关键词