mcpPaylocity MCP Server
2025.03.11
0
Python人力资源薪资管理金融服务
mcpPaylocity 是一个基于 Model Context Protocol (MCP) 的服务器，用于从 Paylocity API 端点获取数据。它提供了多种资源和工具，用于访问和管理 Paylocity 系统中的员工信息、薪资数据、税务信息等。
View on GitHub
Overview
基本能力
产品定位
mcpPaylocity 是一个专门用于与 Paylocity 人力资源和薪资系统集成的 MCP 服务器，旨在简化 Paylocity API 的数据访问和管理。
核心功能
- 提供自定义
paylocity://URI 方案访问 Paylocity 数据 - 实现多种 Paylocity API 资源，包括员工列表、员工详情、薪资数据、公司代码、地方税务和薪资单详情
- 提供多种工具，用于获取特定数据，如员工列表、员工详情、薪资数据等
适用场景
- 人力资源管理系统集成
- 薪资数据处理和分析
- 员工数据管理和报告
工具列表
fetch_employees: 获取公司所有员工列表fetch_employee_details: 获取特定员工的详细信息fetch_employee_earnings: 获取特定员工的薪资数据fetch_company_codes: 获取公司特定资源的代码fetch_employee_local_taxes: 获取特定员工的地方税务信息fetch_employee_paystatement_details: 获取特定日期的薪资单详情
常见问题解答
- 安全问题: 服务器缓存认证令牌，这些文件包含敏感凭证，不应提交到版本控制。
- 配置问题: 需要设置环境变量
PAYLOCITY_CLIENT_ID,PAYLOCITY_CLIENT_SECRET,PAYLOCITY_COMPANY_IDS, 和PAYLOCITY_ENVIRONMENT。
使用教程
使用依赖
需要设置以下环境变量：
- PAYLOCITY_CLIENT_ID
- PAYLOCITY_CLIENT_SECRET
- PAYLOCITY_COMPANY_IDS
- PAYLOCITY_ENVIRONMENT
安装教程
- 在 Claude Desktop 中配置 MCP 服务器
- MacOS:
~/Library/Application\ Support/Claude/claude_desktop_config.json -
Windows:
%APPDATA%/Claude/claude_desktop_config.json -
添加服务器配置
json "mcpServers": { "mcpPaylocity": { "command": "uvx", "args": [ "mcppaylocity" ] } }
调试方式
使用 MCP Inspector 进行调试：
npx @modelcontextprotocol/inspector uv --directory /path/to/mcpPaylocity run mcppaylocity