个人助理 MCP 服务器

一款功能强大的个人助理服务器，集成了 Google 日历、Obsidian Vault、Trello 以及网页解析等多种服务。该服务器基于 FastMCP 构建，提供统一的界面来管理您的数字生活。

特征

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

先决条件

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

安装

克隆存储库：
git clone https://github.com/yourusername/personal-assistant-mcp.git cd personal-assistant-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",
                 "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault",
                 "OBSIDIAN_DEFAULT_FOLDER": "your_default_folder",
                 "LOG_PATH": "/path/to/log.txt",
                 "TRELLO_TOKEN": "your_trello_token",
                 "TRELLO_API_KEY": "your_trello_api_key"
         }
      }
   }
}

将路径和凭据替换为您的实际值：

command ：Python 虚拟环境的 Python 可执行文件的路径
args ：项目main.py文件的路径
GOOGLE_CREDENTIALS_PATH ：您的 Google 日历凭据文件的路径
GOOGLE_TOKEN_PATH ：您的 Google 日历令牌文件的路径
OBSIDIAN_VAULT_PATH ：你的 Obsidian 保险库的路径
OBSIDIAN_DEFAULT_FOLDER ：保管库中将创建新笔记的默认文件夹的路径
TRELLO_TOKEN ：您的 Trello API 令牌
TRELLO_API_KEY ：您的 Trello API 密钥

发展

该项目使用 Poetry 进行依赖管理
所有工具都在main.py中注册
特定于服务的实现位于services/目录中
遵循 PEP 8 Python 代码风格指南

贡献

分叉存储库
创建你的功能分支（ git checkout -b feature/amazing-feature ）
提交您的更改（ git commit -m 'Add some amazing feature' ）
推送到分支（ git push origin feature/amazing-feature ）
打开拉取请求

加入：

电报博客

Personal Assistant MCP Server

Integrations

个人助理 MCP 服务器

特征

先决条件

安装

配置

用法

Anthropic Claude 桌面配置

发展

贡献