基于FastMCP创建MCP服务器的小白级教程

以下是基于windows 11操作系统环境的开发步骤。

1、python环境搭建

访问官网:https://www.python.org/。下载相应的版本(如:3.13.5),然后安装。

安装完成之后,使用命令行工具输入python,显示如下图即可安装成功。

2、fastmcp项目的初始化

fastmcp的文档地址:FastMCP MCP框架,推荐使用UV来安装和管理 FastMCP。

我要在H:\mcp-demo文件夹下创建我的项目,使用vs code打开该文件夹项目。

(1)UV的安装

进入UV官网的安装文档Installation | uv,如下图:

安装完成之后,在命令行里录入UV时,出现如下信息,即为安装成功:

(2)使用UV来初始化项目,如下图:

即可自动初始化如下图所示的项目:

(3)使用uv创建python虚拟环境

项目目录里多了一个文件夹。

(4)按照上一步的提示,使用".venv\Scripts\activate"进行激话,因为我们是windows环境,所以打开.venv目录查看

使用.venv\Scripts\activate.bat

bash 复制代码
.venv\Scripts\activate.bat

这个时候,项目的环境变量更新了。验证方式:输入python,即可出现我们希望的python版本信息,如图

使用exit()退回。

(5)安装fastmcp

参考fastmcp文档

bash 复制代码
uv pip install fastmcp

等待安装完成。

3、编写mcp工具和资源

安装完成之后,即可编写代码,打开main.py文件,参考官方示例代码如下:

python 复制代码
import os
from pathlib import Path
from typing import List,Dict
from fastmcp import FastMCP

mcp= FastMCP(name="我的文件MCP服务器")

# 在应用启动前设置
# os.environ["DANGEROUSLY_OMIT_AUTH"] = "true"

@mcp.tool(description="获取当前电脑桌面的路径")
def get_desktop() -> str:
    return f"H:\mcp-demo"

@mcp.tool(description="遍历文件夹下的所有文件")
def list_files_in_directory(directory_path: str) -> List[str]:
    path = Path(directory_path)

    if not path.exists() or not path.is_dir():
        return [{"error": "指定的路径不存在或不是一个目录"}]
    
    files=[]
    for file in path.iterdir():
        if file.is_file():
            files.append({"file_name":file.name, "file_path": str(file)})
    return files


@mcp.tool(description="搜索文件夹下的特定文件")
def search_files(directory_path: str, keyword: str) -> List[Dict[str, str]]:
    path = Path(directory_path)

    if not path.exists() or not path.is_dir():
        return [{"error": "指定的路径不存在或不是一个目录"}]
    
    results = []
    for file in path.iterdir():
        if file.is_file() and keyword.lower() in file.name.lower():
            results.append({"file_name": file.name, "file_path": str(file)})
    
    return results


# def main():
#    print("Hello from workon-mcp!")


if __name__ == "__main__":
    # main()
    mcp.run()  # 启动MCP服务器 # Default: uses STDIO transport
    # mcp.run(transport="sse", host="127.0.0.1", port=8000)

4、运行测试

使用 fastmcp run 来进行运行调试。

相关推荐
wflynn26 分钟前
GitHub 日榜趋势速报 | 2026-11-17
开源·github
TomEval10 小时前
【测AI】第26篇:线上模型监控与告警体系 — 测试不是终点
人工智能·python·功能测试·ai
prince_zxill10 小时前
PEP 751 pylock.toml 实测:pip 26.3 装 6 个包版本全钉死,但 [web] 选不中任何东西
python·pip·依赖管理·pep 751
一只爱撸猫的程序猿11 小时前
五周、两个开源仓库、九次拦截之后:AI 时代程序员缺的到底是什么
人工智能·后端·开源
Thanks_ks12 小时前
Python 的垃圾回收——引用计数撑起日常,分代回收收拾残局
python·内存管理·垃圾回收·循环引用·引用计数·gc 模块·weakref
CyrusYiVPP12 小时前
实测 uv 0.13.7:同一套包,pip 装 94 秒,它只用 19 秒
人工智能·python
yiangL_12 小时前
Python 学习笔记:递归、turtle绘图、字符串与函数
笔记·python·学习
tianyuanwo13 小时前
PostgreSQL 部署运维实战总结:从安装踩坑到生产可用
运维·数据库·postgresql
Decay__13 小时前
SQLServer 优化案例集 —— 慢 SQL 优化、索引重构与参数调整收益对比
运维·数据库·sql·mysql·架构
lula88814 小时前
PVC-U、PVC-C、PVC-O 差一个字母,差的是三种增强路线
python