项目简介

这是一个完整的Model Context Protocol (MCP) 服务器演示项目,使用FastMCP框架实现了费用跟踪功能。项目展示了如何构建、调试、部署MCP服务器,并支持与GitHub Copilot、LangChain等AI工具集成。

主要功能

  • 费用管理工具:提供添加费用、查询费用数据的功能
  • 多种传输协议:支持stdio(用于VS Code集成)和HTTP传输
  • 认证集成:支持Keycloak和Microsoft Entra ID OAuth认证
  • 云部署支持:完整支持Azure Container Apps部署
  • 开发工具链:集成调试、监控、测试等完整开发体验
  • 多框架支持:与Microsoft Agent Framework、LangChain等AI框架集成

安装步骤

  1. 环境准备:确保安装Python 3.13+、Azure Developer CLI、Docker等工具
  2. 依赖安装:使用uv sync安装项目依赖
  3. 环境配置:复制.env-sample到.env并配置API凭证

服务器配置

该项目提供三种MCP服务器配置:

  • expenses-mcp:标准stdio传输服务器
  • expenses-mcp-debug:带调试支持的stdio服务器
  • HTTP服务器:通过HTTP协议在端口8000提供服务

基本使用方法

  1. 本地运行:使用uv run命令启动服务器
  2. GitHub Copilot集成:通过VS Code配置连接MCP服务器
  3. 调试与监控:支持VS Code调试、MCP Inspector测试、OpenTelemetry追踪

信息

分类

开发者工具