FastMCP 开源项目教程
1. 项目介绍
FastMCP 是一个用 Python 编写的轻量级 Model Context Protocol (MCP) 服务器构建框架。MCP 是一种新的、标准化的方式,用于为大型语言模型(LLM)提供上下文和工具。FastMCP 通过简单的装饰器和直观的 Python 代码,使得构建 MCP 服务器变得简单快捷。
FastMCP 的主要特点如下:
- 快速:高级接口意味着更少的代码和更快的开发速度。
- 简单:用最少的模板代码构建 MCP 服务器。
- Pythonic:对 Python 开发者来说使用自然。
- 完整:FastMCP 旨在提供核心 MCP 规范的完整实现。
2. 项目快速启动
以下是快速启动 FastMCP 的步骤:
首先,确保你已经安装了 Python。然后,通过以下命令安装 FastMCP:
uv pip install fastmcp
对于 macOS 用户,可能需要先通过 Homebrew 安装 uv
:
brew install uv
接下来,创建一个简单的 MCP 服务器,暴露一个计算器工具和一些数据。以下是一个示例服务器 server.py
:
from fastmcp import FastMCP
# 创建一个 MCP 服务器
mcp = FastMCP("Demo")
# 添加一个加法工具
@mcp.tool()
def add(a: int, b: int) -> int:
"""两个数相加"""
return a + b
# 添加一个动态问候资源
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
"""获取个性化问候"""
return f"你好,{name}!"
你可以通过以下命令安装该服务器到 Claude Desktop 并与之交互:
fastmcp install server.py
或者,使用 MCP Inspector 测试它:
fastmcp dev server.py
3. 应用案例和最佳实践
Echo 服务器
创建一个简单的 Echo 服务器,将接收到的消息原样返回。
from fastmcp import FastMCP
mcp = FastMCP("Echo Server")
@mcp.tool()
def echo(message: str) -> str:
"""返回接收到的消息"""
return message
SQLite 探索器
创建一个工具,允许 LLM 查询和操作 SQLite 数据库。
import sqlite3
from fastmcp import FastMCP
mcp = FastMCP("SQLite Explorer")
@mcp.tool()
def query_db(query: str) -> str:
"""执行 SQL 查询并返回结果"""
conn = sqlite3.connect('example.db')
cursor = conn.cursor()
cursor.execute(query)
result = cursor.fetchall()
conn.close()
return str(result)
4. 典型生态项目
目前,FastMCP 生态系统中的项目包括但不限于:
- MCP Python SDK:官方提供的低级别 Python SDK,用于直接实现 MCP 协议。
- Claude Desktop:一个桌面应用程序,允许用户与 MCP 服务器交互。
以上教程提供了一个基础的 FastMCP 使用指导,开发者可以根据自己的需求进一步探索和扩展。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考