AI导哈

ERP数据查询服务

Infor CloudSuite MCP Server是一个AI驱动的协调层，通过ION API网关为大型语言模型提供对Landmark业务类数据的结构化访问，支持自然语言查询ERP系统中的财务、供应商、采购订单等数据。

  • by clipham
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 clipham/infor-cloudsuite-mcp

使用说明

Infor CloudSuite MCP服务器

Infor CloudSuite的第一个MCP（模型上下文协议）服务器-一个AI驱动的编排层，通过ION API网关为LLM提供对Landmark业务类数据的结构化访问。

用简单的英语问你的ERP问题。从实时数据中获取答案。

这有什么作用

将Claude（或任何兼容MCP的AI）直接连接到您的Infor CloudSuite环境。通过自然语言查询发票、供应商、总账账户、采购订单、赠款和任何其他Landmark业务类。

示例提示：

  • “显示所有超过10000美元的未结应付账款发票”
  • “为什么3月份公用事业增加了？”
  • “100基金6200账户的年初至今支出是多少？”
  • “比较1月和2月的差旅费用”
  • “列出供应商组1000中的所有供应商及其未清余额”
  • “查找采购订单PO-2024-0042并向我显示其行项目”
  • “是什么推动了本季度办公用品支出的变化？”

快速开始

1.先决条件

  • Python 3.11+
  • 使用ION API网关访问Infor CloudSuite环境
  • Claude Desktop、Claude Code或Claude.ai Pro计划

2.安装

git clone <your-repo-url>
cd infor-cloudsuite-mcp
pip install -e .

3.配置ION API凭据

这是关键步骤-您需要在ION API网关中创建授权应用程序并下载凭据文件。

步骤A：创建授权应用程序

  1. 登录您的Infor CloudSuite环境
  2. 导航至 信息操作系统>ION API （或在汉堡菜单中搜索“ION API”）
  3. 首选 授权应用程序
  4. 点击 +添加 （或“新建”）
  5. 配置：
    • 名字: InforMCP （或任何描述性名称）
    • 类型: 后端服务
    • 描述：“用于AI驱动的CloudSuite访问的MCP服务器”
  6. 保存应用程序

步骤B：创建服务帐户

  1. 仍在爱雍API，请访问 服务账户 新应用程序的部分
  2. 创建新的服务帐户
  3. 将其映射到CloudSuite用户 --该用户决定MCP服务器可以访问什么
    • 对于阶段1（只读），映射到具有查询级别访问权限的用户
    • 用户应该有权访问您要查询的财务模块
    • 不要映射到管理员帐户 --使用最小特权
  4. 注意服务帐户访问密钥和密钥

步骤C：下载凭据

  1. 在您的授权应用程序中，单击 下载凭据
  2. 这将下载a .ionapi 文件（JSON格式）
  3. 把它放在 config/.ionapi 在项目目录中

步骤D：设置环境变量

cp .env.example .env

编辑 .env:

IONAPI_PATH=config/.ionapi
INFOR_DATA_AREA=fsm

这 INFOR_DATA_AREA 取决于您的CloudSuite产品：

  • fsm --CloudSuite财务和供应管理（最常见）
  • hcm --CloudSuite人力资本管理
  • hrt --CloudSuite人力资源人才

4.使用克劳德桌面运行

添加到您的Claude桌面配置(claude_desktop_config.json):

{
  "mcpServers": {
    "infor-cloudsuite": {
      "command": "python",
      "args": ["-m", "infor_mcp.server"],
      "cwd": "/path/to/infor-cloudsuite-mcp",
      "env": {
        "IONAPI_PATH": "/path/to/infor-cloudsuite-mcp/config/.ionapi",
        "INFOR_DATA_AREA": "fsm"
      }
    }
  }
}

重新启动克劳德桌面。您应该在工具选择器中看到Infor CloudSuite工具。

5.使用Claude代码运行

cd infor-cloudsuite-mcp
claude mcp add infor-cloudsuite -- python -m infor_mcp.server

6.使用MCP检查员进行测试

mcp dev src/infor_mcp/server.py

这将在浏览器中打开MCP检查器，您可以在其中交互式地测试工具。

可用工具（第一阶段）

工具 说明
query_business_class 通过字段选择和过滤查询任何Landmark业务类
find_record 按关键字段查找特定记录
list_business_classes 发现可用的商务课程
list_business_class_details 获取业务类的字段元数据
get_field_values 检查类中的字段和样本值
run_form_operation 执行只读表单操作
analyze_gl_variance 带驾驶员识别的跨期总账方差分析

可用提示

提示 描述
ap_aging_analysis 分析应付账款账龄区间和付款优先级
vendor_spend_analysis 按供应商分析支出
gl_account_inquiry 调查总账账户活动和预算
purchase_order_status 检查整个组织的采购订单状态
grant_status_check 审查赠款预算与实际情况
gl_variance_analysis 分析总账账户在不同期间之间发生变化的原因
month_end_close_checklist 月末结账状态和冻结项目

安全说明

  • 这 .ionapi 文件包含OAuth凭据-- 永远不要将其提交给git
  • 服务帐户用户确定访问范围——使用最小权限
  • 所有API调用都可以通过ION API网关日志进行审核
  • 阶段1是只读的——写操作被明确阻止
  • 服务器从不向AI客户端公开凭据

项目结构

infor-cloudsuite-mcp/
├── config/
│   └── .ionapi              # Your credentials (gitignored)
├── src/infor_mcp/
│   ├── __init__.py
│   ├── server.py            # MCP server entry point
│   ├── auth.py              # OAuth token manager
│   ├── client.py            # ION API HTTP client
│   ├── tools/
│   │   ├── __init__.py
│   │   ├── query.py         # Phase 1 read-only tools
│   │   └── analysis.py      # GL variance analysis tools
│   ├── resources/
│   │   ├── __init__.py
│   │   └── reference.py     # Reference data for LLM context
│   └── prompts/
│       ├── __init__.py
│       └── workflows.py     # Pre-built workflow prompts
├── tests/
│   └── __init__.py
├── .env.example
├── .gitignore
├── pyproject.toml
└── README.md

路线图

  • 第一阶段 （当前）：只读查询工具--搜索、列表、分析
  • 第2阶段：写入操作--创建记录、更新记录、运行操作（带确认门）
  • 第三期：代理工作流——多步骤流程执行、计划代理、自主操作

许可证

麻省理工学院

相关 MCP