IBM BOB-SAP Northwind Customer MCP Server

Northwind MCP服务器

模型上下文协议（MCP）服务器，提供对Northwind OData API的访问。此服务器公开了26个用于查询各种Northwind数据库实体和视图的工具。

特性

• 26种综合工具 覆盖所有Northwind端点
• OData查询支持 具有过滤、排序、分页和字段选择功能
• 核心实体：客户、产品、订单、员工、类别、供应商等
• 业务视图：销售报告、发票、产品分析和摘要

安装

npm install
npm run build

可用工具

核心实体工具

1. get_客户 -查询客户数据
2. get_产品 -查询产品目录
3. 获取订单 -查询订单标题
4. 获取订单详情 -查询订单行项目
5. get_员工 -查询员工信息
6. get_类别 -查询产品类别
7. get_供应商 -查询供应商信息
8. get_shippers -查询船运公司
9. get_regions -查询地理区域
10. get_territories -查询销售区域
11. get_customer_demographics -查询客户人口统计数据

业务视图工具

1. get_alphabetical_products -按字母顺序排序的产品
2. get_category_sales_1997 -一九九七年按类别划分的销售额
3. get_current_product_list -当前产品列表
4. get_客户_供应商_城市 -按城市分组的客户和供应商
5. get_invoices -发票明细
6. get_order_details_extended -带有计算功能的扩展订单详细信息
7. 获取订单小计 -订单小计计算
8. get_orders_query -高级订单查询
9. 产品销售-1997 -1997年产品销售额
10. get_products_above_average_price -价格高于平均水平的产品
11. get_products_by_category -按类别分组的产品
12. get_sales_by_category -按类别分组的销售额
13. get_sales_totals_by_amount -按金额列出的销售总额
14. 按季度销售 -季度销售总结
15. 按年份销售 -年度销售总结

查询参数

所有工具都支持以下OData查询参数：

• 过滤器 （可选）：OData筛选器表达式

- 例子： "Country eq 'USA'", "UnitPrice gt 20"

• 顶部 （可选）：要返回的记录数（1-100）
• 跳过 （可选）：要跳过的记录数（用于分页）
• 排序依据 （可选）：排序表达式

- 例子： "CompanyName desc", "UnitPrice asc"

• 选择 （可选）：以逗号分隔的要返回的字段列表

- 例子： "CustomerID,CompanyName,City"

用法示例

获取来自美国的客户

{
  "filter": "Country eq 'USA'",
  "top": 10
}

购买昂贵的产品

{
  "filter": "UnitPrice gt 50",
  "orderby": "UnitPrice desc",
  "top": 20
}

获取带分页的订单

{
  "top": 25,
  "skip": 50,
  "orderby": "OrderDate desc"
}

获取特定客户字段

{
  "select": "CustomerID,CompanyName,City,Country",
  "filter": "City eq 'London'"
}

OData筛选器运算符

• 比较: eq （等于）， ne （不相等）， gt （大于）， ge （大于或等于）， lt （小于）， le （小于或等于）
• 逻辑的: and, or, not
• 字符串: startswith(), endswith(), substringof()
• 例子:

- "Country eq 'USA' and City eq 'Seattle'" - "UnitPrice gt 20 and UnitPrice lt 50" - "startswith(CompanyName, 'A')"

配置

服务器连接到公共Northwind OData API：

https://services.odata.org/v2/northwind/northwind.svc

发展

# Install dependencies
npm install

# Build the server
npm run build

# The server runs via stdio transport
node build/index.js

MCP集成

添加到MCP设置中：

{
  "mcpServers": {
    "northwind": {
      "command": "node",
      "args": ["C:/Users/YOUR_USERNAME/AppData/Roaming/Bob-Code/MCP/northwind-server/build/index.js"]
    }
  }
}

许可证

麻省理工学院

与Bob一起制作