PensionPro

PensionPro MCP 服务

一个本地开源 MCP 服务，为 AI 助手提供与 PensionPro REST API 交互的工具。

功能

• 计划查询与搜索 — 按名称、状态、类型或客户搜索计划。查看包含联系人、周期和费用表的详细计划信息。
• 项目与任务工作流 — 搜索项目、查看任务详情、完成或取消完成任务、重新分配任务，以及根据模板创建项目。
• 客户与联系人查询 — 搜索客户和联系人，查看包含关联计划的客户详情。
• 待办事项管理 — 搜索、创建和更新与计划、项目或联系人关联的待办事项。
• 备注 — 为计划、项目、任务和联系人添加备注并检索备注。

先决条件

• Python 3.12+
• PensionPro API 密钥和用户名

安装

从 PyPI 安装：

pip install pension-pro-mcp

也可以通过 uvx 直接运行（无需安装）：

uvx pension-pro-mcp

配置

设置以下环境变量：

export PENSION_PRO_API_KEY=your_api_key
export PENSION_PRO_USERNAME=your_username

Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "pension-pro": {
      "command": "uvx",
      "args": ["pension-pro-mcp"],
      "env": {
        "PENSION_PRO_API_KEY": "your_api_key",
        "PENSION_PRO_USERNAME": "your_username"
      }
    }
  }
}

Claude Code

添加到项目的 .mcp.json：

{
  "mcpServers": {
    "pension-pro": {
      "command": "uvx",
      "args": ["pension-pro-mcp"],
      "env": {
        "PENSION_PRO_API_KEY": "your_api_key",
        "PENSION_PRO_USERNAME": "your_username"
      }
    }
  }
}

可用工具

工具	描述
search_plans	按名称、状态、类型或客户搜索和筛选计划
get_plan_details	获取包含联系人、周期、服务、投资和费用的计划
get_plan_projects	获取计划的项目及任务完成情况摘要
search_projects	按状态、类型或计划搜索和筛选项目
get_project_details	获取包含任务组、任务、参与者、备注和文件的项目
get_task_details	获取单个任务的状态、分配情况和备注
complete_task	将任务标记为已完成
uncomplete_task	将任务恢复为未完成状态
reassign_task	将任务重新分配给其他员工
create_project_from_template	根据模板创建新项目
search_clients	按公司名称搜索和筛选客户
get_client_details	获取包含计划和备注的客户信息
search_contacts	按姓名或客户搜索和筛选联系人
search_todos	搜索和筛选待办事项
get_todo	获取待办事项及其评论
create_todo	创建与实体关联的新待办事项
update_todo	更新待办事项详情
add_note	为计划、项目、任务或联系人添加备注
get_notes	获取实体的备注
search_api_paths	按关键字搜索 PensionPro API 端点
get_api_endpoint	获取指定 API 端点的完整详情
search_api_schemas	按关键字搜索 API 数据模型/架构
get_api_schema	获取 API 数据模型的完整定义
search_help_articles	按关键字搜索 PensionPro 帮助中心文章
get_help_article	获取帮助文章的完整内容
list_help_sections	列出可用的帮助分区及文章数量

开发

git clone https://github.com/douglaslinsmeyer/pension-pro-mcp.git
cd pension-pro-mcp
pip install -e ".[dev]"
pytest

刷新帮助文章

可以从 PensionPro 知识库刷新随附的帮助文章：

python scripts/scrape_docs.py

许可证

MIT