B2B集成协议服务器

一个基于模型上下文协议(MCP)的服务器,使AI助手能够通过标准化接口与Sterling B2B/Filegateway交互。

  • by ebasso
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 ebasso/sterling-b2b-mcp-server

使用说明

Sterling B2B集成商/文件网关MCP服务器

A. 模型上下文协议 (MCP)服务器,使AI助手能够通过标准化接口与Sterling B2B/Filegateway进行交互。

特性

  • [x] 贸易伙伴
    • [x] 列出贸易伙伴
  • []Filegateway社区
    • []列出贸易伙伴
  • []发现和探索指标
    • []列出可用指标
    • []获取特定指标的元数据
    • []查看即时查询结果
  • [x] 身份验证支持
    • [x] 来自环境变量的基本身份验证
  • []Docker容器化支持
  • []为人工智能助手提供交互式工具

工具列表是可配置的,因此您可以选择要向MCP客户端提供哪些工具。 如果你不使用某些功能,或者你不想占用太多的上下文窗口,这很有用。

用法

  1. 确保您的Sterling B2Bi/Filegateway服务器可以从运行此MCP服务器的环境中访问。

  2. 请确保您的用户具有访问REST API服务的权限。

  3. 通过以下方式为Sterling B2B服务器配置环境变量 .env 文件或系统环境变量:

# Required: Sterling B2Bi/Filegateway configuration
B2BI_URL=http://your-sterling-b2bi-server:5000
B2BI_RESTAPI_URL=http://your-sterling-b2bi-server:5076

# Authentication credentials
B2BI_USERNAME=your_username
B2BI_PASSWORD=your_password
  1. 将服务器配置添加到客户端配置文件中。例如,对于Claude Desktop:
{
  "mcpServers": {
    "sterlingb2b": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "B2BI_URL",
        "-e",
        "B2BI_RESTAPI_URL",
        "-e",
        "B2BI_USERNAME", 
        "-e",
        "B2BI_PASSWORD",
        "quay.io/ebasso/sterling-b2b-mcp-server:latest"
      ],
      "env": {
        "B2BI_URL": "<url>",
        "B2BI_RESTAPI_URL": "<url>",
        "B2BI_USERNAME": "<username>",
        "B2BI_PASSWORD": "<password>",
      }
    }
  }
}

发展

欢迎投稿!如果您有任何建议或改进,请打开问题或提交拉取请求。

此项目使用 uv 管理依赖关系。安装 uv 按照您平台的说明进行操作:

curl -LsSf https://astral.sh/uv/install.sh | sh

然后,您可以创建一个虚拟环境,并使用以下命令安装依赖项:

uv venv
source .venv/bin/activate  # On Unix/macOS
.venv\Scripts\activate     # On Windows
uv pip install -e .

项目结构

该项目由 src 目录结构:

sterling-b2b-mcp-server/
├── src/
│   └── sterling_b2b_mcp_server/
│       ├── __init__.py      # Package initialization
│       ├── server.py        # MCP server implementation
│       ├── sterling_b2b.py  # Sterling B2Bi/Filegateway Rest APIs helper
├── Dockerfile               # Docker configuration
├── docker-compose.yml       # Docker Compose configuration
├── .dockerignore            # Docker ignore file
├── pyproject.toml           # Project configuration
└── README.md                # This file

测试

该项目包括一个全面的测试套件,可确保功能并帮助防止回归。

使用pytest运行测试:

# Install development dependencies
uv pip install -e ".[dev]"

# Run the tests
pytest

# Run with coverage report
pytest --cov=src --cov-report=term-missing

测试分为:

  • 配置验证测试
  • 服务器功能测试
  • 错误处理测试
  • 主要应用测试

添加新功能时,请同时添加相应的测试。

工具

工具 类别 描述
get_trading_partners 查询 Sterling B2Bi/Filegateway中所有交易伙伴的列表
get_trading_partners_with_details 查询 Sterling B2Bi/Filegateway中所有交易伙伴的详细信息列表

许可证

麻省理工学院