FastAPI MCP 服务器

该项目展示了如何使用fastapi-mcp创建一个模型上下文协议(MCP)服务器,使大型语言模型(LLM)能够连接并与REST API交互。

  • by RobertoRuben
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 robertoruben/mcp-northwind-fastapi-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
    
  2. 运行应用程序:

    uvicorn src.main:app --reload
    
  3. 访问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调用。 ✨