PensionPro

io.github.douglaslinsmeyer由 GitHub 账号 douglaslinsmeyer 发布v0.2.1更新于 Oct 24, 2026

MCP server for the PensionPro pension administration REST API.

已验证STDIO仅桌面效率与工作流商业与电商

概览

AI 生成的概览

让助手通过 PensionPro REST API 搜索和管理养老金管理数据，包括计划、项目、任务、客户、联系人、待办和备注。

可以做什么
这是一个封装 PensionPro REST API 的本地 MCP 服务器。它提供工具来搜索和读取计划、项目、任务、客户、联系人和待办事项，也支持写入操作：完成任务或恢复未完成、重新分配任务、从模板创建项目、创建和更新待办，以及添加备注。此外还提供搜索 PensionPro API 端点、数据模型和帮助中心文章的工具。
适用场景
当助手需要处理 PensionPro 养老金管理记录时使用，例如查询计划或客户详情、跟踪项目和任务状态，或记录备注和待办，而无需离开对话。面向拥有 API 访问权限的 PensionPro 用户。
运行要求
作为本地 Python 包运行（需要 Python 3.12+），可从 PyPI 安装或用 uvx 直接运行。需要 PensionPro API 密钥和用户名，通过环境变量 PENSION_PRO_API_KEY 和 PENSION_PRO_USERNAME 提供。仅支持桌面端，需要访问 PensionPro API 的网络连接。
安装前请注意
该服务器持有 PensionPro API 密钥和用户名，应保存在本地配置中，不要外传。多个工具会修改 PensionPro 中的数据：complete_task、uncomplete_task、reassign_task、create_project_from_template、create_todo、update_todo 和 add_note。在允许助手执行这些操作前请先确认。

安装

在 SourceWeft 中

  1. 打开 控制台中的 PensionPro，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

PensionPro MCP Server

A local, open-source MCP server that provides AI assistants with tools to interact with the PensionPro REST API.

Features

  • Plan Lookup & Search — Search plans by name, status, type, or client. Get comprehensive plan details with contacts, cycles, and fee schedules.
  • Project & Task Workflow — Search projects, view task details, complete/uncomplete tasks, reassign tasks, and create projects from templates.
  • Client & Contact Lookup — Search clients and contacts, view client details with associated plans.
  • To-Do Management — Search, create, and update to-dos linked to plans, projects, or contacts.
  • Notes — Add and retrieve notes on plans, projects, tasks, and contacts.

Prerequisites

  • Python 3.12+
  • A PensionPro API key and username

Installation

Install from PyPI:

bash
pip install pension-pro-mcp

Or run directly with uvx (no install required):

bash
uvx pension-pro-mcp

Configuration

Set the following environment variables:

bash
export PENSION_PRO_API_KEY=your_api_keyexport PENSION_PRO_USERNAME=your_username

Claude Desktop

Add to your claude_desktop_config.json:

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

Add to your project's .mcp.json:

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

Available Tools

ToolDescription
search_plansSearch and filter plans by name, status, type, or client
get_plan_detailsGet plan with contacts, cycles, services, investments, fees
get_plan_projectsGet projects for a plan with task completion summaries
search_projectsSearch and filter projects by status, type, or plan
get_project_detailsGet project with task groups, tasks, participants, notes, and files
get_task_detailsGet a single task with state, assignment, and notes
complete_taskMark a task as complete
uncomplete_taskRevert a task to incomplete
reassign_taskReassign a task to a different employee
create_project_from_templateCreate a new project from a template
search_clientsSearch and filter clients by company name
get_client_detailsGet client with plans and notes
search_contactsSearch and filter contacts by name or client
search_todosSearch and filter to-dos
get_todoGet a to-do with its comments
create_todoCreate a new to-do linked to an entity
update_todoUpdate a to-do's details
add_noteAdd a note to a plan, project, task, or contact
get_notesGet notes for an entity
search_api_pathsSearch PensionPro API endpoints by keyword
get_api_endpointGet full details for a specific API endpoint
search_api_schemasSearch API data models/schemas by keyword
get_api_schemaGet the full definition of an API data model
search_help_articlesSearch PensionPro help center articles by keyword
get_help_articleGet the full content of a help article
list_help_sectionsList available help sections with article counts

Development

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

Refreshing Help Articles

The bundled help articles can be refreshed from the PensionPro knowledge base:

bash
python scripts/scrape_docs.py

License

MIT

来源：README.md，提交 28f3799

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分