养老金管理接口服务

一个本地开源的MCP服务器,为AI助手提供与PensionPro REST API交互的工具,支持养老金计划查询、项目管理、客户联系管理等功能。

  • by douglaslinsmeyer
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 douglaslinsmeyer/pension-pro-mcp

使用说明

PensionPro 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_config.json:

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

克劳德代码

添加到您的项目 .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

许可证

麻省理工学院