Ariba MCP

SAP Ariba MCP服务器

A. 模型上下文协议（MCP）服务器 这暴露了 48个SAP Ariba API 作为与Claude兼容的工具。用Python和 FastMCP.

这使Claude（或任何兼容MCP的AI）能够通过自然语言与SAP Ariba采购、采购、供应商管理、合同、目录和供应链数据进行交互。

API参考： https://help.sap.com/docs/ariba-apis 开发者门户： https://developer.ariba.com

______________________________________________________________________

建筑

┌─────────────────────────────────────────────────┐
│  Consumer Layer                                  │
│  Claude Desktop / Claude Code / Custom App       │
└────────────────────┬────────────────────────────┘
                     │ MCP (stdio)
┌────────────────────▼────────────────────────────┐
│  ariba-mcp Server (this project)                 │
│                                                  │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐       │
│  │ 6 Domain │  │ Auth     │  │ Client   │       │
│  │ Folders  │──│ OAuth2.0 │──│ httpx    │       │
│  │ 48 APIs  │  │ cached   │  │ async    │       │
│  └──────────┘  └──────────┘  └────┬─────┘       │
└────────────────────────────────────┼─────────────┘
                                     │ HTTPS
┌────────────────────────────────────▼─────────────┐
│  SAP Ariba APIs                                   │
│  OAuth: api.ariba.com                             │
│  Data:  openapi.ariba.com/api                     │
└──────────────────────────────────────────────────┘

______________________________________________________________________

所有48个API--6个域文件夹

1.业务网络-- 工具/商业网络/

2.目录-- 工具/目录/

3.概述-- 工具/概述/

4.采购-- 工具/采购/

5.战略采购-- 工具/战略采购/

6.供应商管理-- 工具/供应商管理/

______________________________________________________________________

先决条件

• Python 3.11+
• 紫外线 （推荐）或pip
• SAP Ariba API证书 --一个人为团队提供它们

______________________________________________________________________

凭证设置（一次性）

一名团队成员在SAP Ariba开发人员门户上注册并共享凭据：

1. 首选https://developer.ariba.com
2. 注册新应用程序
3. 启用所需的API
4. 注： OAuth客户端ID, 客户端密钥, API密钥, 领域 名字
5. 创建 .env 并安全地共享：

cp .env.example .env
# Fill in credentials

永不承诺 .env 到git。

______________________________________________________________________

快速开始

# Clone and install
git clone https://github.com/nitishsm2002/ariba-mcp.git
cd ariba-mcp
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"

# Add .env file (get from credentials owner)

# Run the server
python -m ariba_mcp.server

# Test with MCP Inspector
npx @modelcontextprotocol/inspector python -m ariba_mcp.server

连接到克劳德桌面

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ariba": {
      "command": "python",
      "args": ["-m", "ariba_mcp.server"],
      "cwd": "/path/to/ariba-mcp"
    }
  }
}

______________________________________________________________________

项目结构

ariba-mcp/
├── src/ariba_mcp/
│   ├── server.py                       # FastMCP entrypoint
│   ├── config.py                       # Settings (reads .env)
│   ├── auth.py                         # OAuth 2.0 client credentials
│   ├── client.py                       # Async HTTP client (views, jobs, resources)
│   ├── errors.py                       # Error handling
│   ├── models/common.py               # Shared Pydantic models
│   └── tools/
│       ├── __init__.py                 # Registers all 6 domain folders
│       ├── business_network/           # 14 APIs — POs, invoices, ship notices, planning
│       │   ├── __init__.py
│       │   ├── _example.py
│       │   └── .py           # ← team members add files here
│       ├── catalog/                    # 7 APIs — catalogs, content, connectivity
│       │   ├── __init__.py
│       │   ├── _example.py
│       │   └── .py
│       ├── general/                    # 14 APIs — approvals, audit, monitoring, config
│       │   ├── __init__.py
│       │   ├── _example.py
│       │   └── .py
│       ├── procurement/                # 7 APIs — reporting, contracts, compliance
│       │   ├── __init__.py
│       │   ├── _example.py
│       │   └── .py
│       ├── strategic_sourcing/         # 9 APIs — sourcing projects, events, bids
│       │   ├── __init__.py
│       │   ├── _example.py
│       │   └── .py
│       └── supplier_management/        # 8 APIs — supplier data, risk, profiles
│           ├── __init__.py
│           ├── _example.py
│           └── .py
├── tests/
├── .agents/skills/mcp-builder/        # MCP builder reference docs
├── pyproject.toml
├── .env.example
├── CONTRIBUTING.md
└── .gitignore

______________________________________________________________________

如何实现您的API

每个文件夹都有一个 _example.py 使用工作工具进行复制。添加API：

1. 在中查找正确的文件夹 src/ariba_mcp/tools/ （见上表）
2. 看 _example.py 在该图案的文件夹中
3. 创建一个 新的.py文件 以您的API命名（例如。 supplier_data_extraction.py)
4. 定义a register(mcp, client) 功能与您 @mcp.tool 里面
5. 打开文件夹 __init__.py 并添加您的导入+ register() 呼叫
6. 在上查找确切的端点路径 开发者门户
7. MCP检验员测试： npx @modelcontextprotocol/inspector python -m ariba_mcp.server

看 贡献.md 了解详细的编码模式。

______________________________________________________________________

配置参考

______________________________________________________________________

许可证

麻省理工学院