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 使用指导，开发者可以根据自己的需求进一步探索和扩展。