Northwind FastAPI MCP Example

🚀 Northwind FastAPI MCP示例

该项目演示了如何使用fastapi-mcp创建一个模型上下文协议（mcp）服务器，该服务器允许大型语言模型（LLM）连接REST API并与之交互。

📋 概述

Northwind API是一个简单的示例，它展示了如何通过传统的REST API和MCP端点公开经典Northwind数据库中的数据，使LLM可以查询和理解这些数据。

🏁 入门指南

先决条件

• Python 3.10+🐍
• 虚拟环境工具🔧

安装

1. 克隆存储库并安装依赖项：

   git clone https://github.com/RobertoRuben/mcp-northwind-fastapi-example.git
   cd mcp-northwind-fastapi-example
   python -m venv venv
   venv\Scripts\activate  # On Windows
   pip install -r requirements.txt

1. 运行应用程序：

   uvicorn src.main:app --reload

1. 访问API文档： http://localhost:8000/api/v1/docs 📝

🔌 可用端点

REST API端点

• GET /api/v1/products：列出所有产品📦

MCP端点

• http://localhost:8000/mcp：LLM连接的模型上下文协议端点🤖

🔗 将LLM连接到API

此示例演示fastapi-mcp如何在REST API和大型语言模型之间创建桥梁：

1. 传统的REST端点在以下位置提供结构化数据 /api/v1/products* 📊
2. MCP终点位于 /mcp 允许LLM以编程方式发现API并与之交互🧠
3. LLM可以理解您的数据模式并自动执行适当的API调用。 ✨