Peoplesoft MCP

PeopleSoft MCP服务器

模型上下文协议（MCP）服务器，使AI助手能够查询和理解PeopleSoft HCM数据库。此服务器为人力资源、工资单、福利、绩效和PeopleTools元数据提供语义工具，允许用准确的SQL查询回答自然语言问题。

特性

• 41语义工具 涵盖所有主要PeopleSoft HCM模块
• 4文档资源 PeopleSoft概念和查询模式
• 直接数据库访问 通过Oracle瘦客户端（不需要JDBC）
• PeopleTools自省 了解系统架构
• 有效的约会支持 内置于所有查询中

快速开始

先决条件

• Python 3.11+
• Oracle数据库与PeopleSoft HCM 9.2实例的连接
• 紫外线 包管理器（推荐）

安装

# Clone the repository
git clone 
cd peoplesoft-mcp

# Install dependencies
uv sync

配置

1. 复制示例环境文件并添加您的凭据：

cp .env.example .env

1. 编辑 .env 使用您的数据库凭据：

ORACLE_DSN=hostname:port/service_name
ORACLE_USER=your_username
ORACLE_PASSWORD=your_password

1. 编辑 .cursor/mcp.json 并更新安装路径。

运行服务器

uv run peoplesoft_server.py

游标IDE集成

MCP配置(.cursor/mcp.json)应该看起来像：

{
  "mcpServers": {
    "peoplesoft": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp_ps/",
        "run",
        "peoplesoft_server.py"
      ]
    }
  }
}

凭据从加载 .env 自动-无需在MCP配置中包含它们。

可用工具

模式内省（5个工具）

人力资源模块（5个工具）

工资模块（5个工具）

福利模块（4个工具）

性能模块（3个工具）

PeopleTools模块（18个工具）

直接查询（1个工具）

可用资源

项目结构

peoplesoft-mcp/
├── peoplesoft_server.py    # Main MCP server entry point
├── db.py                   # Database connection management
├── tools/                  # Semantic tool modules
│   ├── introspection.py    # Schema discovery tools
│   ├── hr.py               # HR module tools
│   ├── payroll.py          # Payroll module tools
│   ├── benefits.py         # Benefits module tools
│   ├── performance.py      # ePerformance tools
│   └── peopletools.py      # PeopleTools metadata tools
├── tests/                  # Test suites
│   ├── test_business_questions.py   # HR business scenarios
│   └── test_peopletools_questions.py # Technical consultant scenarios
├── docs/                   # Documentation resources
│   ├── peoplesoft_concepts.md
│   ├── peoplesoft_schema_guide.md
│   ├── peopletools_guide.md
│   ├── sql_query_examples.md
│   ├── peopletools-tables-by-tool.md   # Tables required per tool
│   └── migration-analysis.md   # Migration planning notes
└── pyproject.toml          # Project configuration

运行测试

# Set environment variables
export ORACLE_DSN="hostname:port/service_name"
export ORACLE_USER="username"
export ORACLE_PASSWORD="password"

# Run all tests
uv run pytest tests/ -v -s

# Run specific test suite
uv run pytest tests/test_business_questions.py -v -s
uv run pytest tests/test_peopletools_questions.py -v -s

查询示例

MCP支持自然语言问题，如：

商务问题：

• “每家公司有多少在职员工？”
• “各部门的平均工资是多少？”
• “谁向X经理汇报？”
• “向我展示没有指定主管的员工”

技术问题：

• “PS_JOB有哪些字段？”
• “DEPTID字段在哪里使用？”
• “JOB记录上运行的PeopleCode是什么？”
• “HR_ABSV_JOB_EFFDT使用什么SQL？”
• “搜索引用PS_ABSV_REQUEST的SQL对象”
• “解释PeopleSoft中的有效约会”

发展

添加新工具

1. 在中创建新模块 tools/ 或添加到现有模块
2. 定义使用的异步函数 db.execute_query()
3. 添加一个 register_tools(mcp) 函数
4. 导入并注册 peoplesoft_server.py

关键概念

• 有效约会：大多数PeopleSoft表使用EFFDT/EFFSEQ进行历史记录
• 设置 ID：控制跨业务部门的数据共享
• 翻译价值观：通过PSXLATITEM解码的短代码
• EMPLID/epl-RCD：员工ID+就业记录号

许可证

麻省理工学院

更新日志

v0.2.1（2026-03-02）

• 添加 get_sql_definition -通过SQLID从PSSQLTEXTDEFN获取SQL文本
• 添加 search_sql_definitions -按文本搜索SQL对象
• PeopleTools兼容性：针对不同PeopleTools版本的不同列名调整PSPNLGROUP、PSPNLFIELD、PSAEAPPLDEFN、PSAESTEPDEFN查询
• 添加 docs/peopletools-tables-by-tool.md -每个工具所需的表格

v0.2.0（2026-02-28）

• 添加了39个语义工具的模块化工具架构
• 新增PeopleTools自检模块（16个工具）
• 添加了全面的测试套件（42个测试）
• 将连接池替换为直接连接，以提高可靠性
• 新增4个文档资源
• 改进了所有查询中的有效约会模式