本文探讨了将测试工具改造为符合MCP服务协议标准，并接入AI Agent，以打造智能测试管家的可行性。文章重点介绍了基于FastAPI框架构建社区造数服务，并接入MCP协议，实现自动化测试数据生成。通过FastAPI-MCP库简化了MCP服务的接入流程，并演示了与Cursor等AI Agent工具的集成，最终实现通过自然语言描述完成复杂的造数任务。

💡作者设想将测试工具改造为符合MCP协议，并接入AI Agent，以实现智能测试数据生成的目的，从而提高测试效率。

🛠️文章介绍了基于FastAPI框架构建社区造数服务，并使用uv工具管理依赖，通过FastAPI-MCP库简化了MCP服务的接入流程。

✅文章详细阐述了FastAPI-MCP库的安装和使用方法，包括自定义配置、工具命名等，并提供了与Cursor等AI Agent工具的集成案例。

⚙️通过将FastAPI服务暴露为MCP工具，结合Cursor等AI Agent，用户只需用自然语言描述测试需求，即可自动完成复杂的造数任务，例如创建测试账号、发布动态等。

🚀文章强调了在接入AI Agent时，清晰的接口文档和规范的命名对AI理解和调用的重要性，并提供了调优案例。

原创 阿凯 2025-05-26 18:31 上海

今年关MCP 的概念非常火，作为技术一线者，若把测试工具都改造成符合 MCP 服务协议标准，然后接入AI Agent，打造一个集万千工具于一体的智能管家来提效，这个设想就需要我们不断往下拆解成可落地的任务模块，这里我们先从造数开始。

## uv命令
1. 安装uv ： `curl -LsSf https://astral.sh/uv/install.sh | sh`
2. 创建环境 - 自定义环境名称和Python版本   `uv venv tools_venv --python 3.12`
3. 激活环境    `source tools_venv/bin/activate`
4. 安装依赖包    `uv pip install -r pyproject.toml`
## 本地启动项目
直接运行main.py文件中的main方法即可，debug模式自己pycharm中设置
if __name__ == "__main__":
    import uvicorn
    uvicorn.run(app, host="0.0.0.0", port=8000)

## 项目结构
```bash
├── main.py  # 启动 APP 入口文件
├── README.md  # 开发手册
├── Dockerfile  # Docker 镜像文件
├── alembic  # alembic 迁移 DB 自动生成的相关文件
│   ├── README
│   ├── .env.py
│   ├── script.py.mako
│   └── versions  # 存放每次迁移的版本，可用于回滚 DB 版本
├── alembic.ini  # alembic 配置文件
├── app
│   ├── __init__.py  # 注册 app
│   ├── api  # api 开发目录
│   ├── core  # app 的全局配置
│   ├── crud  # 每个 table 的增删改查操作
│   ├── db  # db 配置
│   ├── models  # 存放表结构
│   ├── schemas  # pydantic 模型
│   └── utils  # 工具类
├── .pre-commit-config.yaml  # 配置 git commit 时自动检测工具
└── pyproject.toml  # 依赖库管理
```

# server.py
from mcp.server.fastmcp import FastMCP
from tools.tools_set import get_user_info
import uvicorn
# Create an MCP server
mcp = FastMCP("Demo")
@mcp.tool()
async def get_user_info_tool(mobile: str) -> Coroutine[Any, Any, Any]:
    """根据输入的手机号获取用户信息
    
    Args:
        mobile: 手机号
    """
    info = get_user_info(mobile)
    return info
if __name__ == "__main__":
    """Initialize and run the server"""
    # mcp.run(transport="sse")
    """Start the FastAPI server with uvicorn"""
    uvicorn.run(app, host="0.0.0.0", port=8003)

from fastapi import FastAPI
import uvicorn
from fastapi_mcp import FastApiMCP
# Create (or import) a FastAPI app
app = FastAPI()
# Create an MCP server based on this app
mcp = FastApiMCP(app)
# Mount the MCP server directly to your app
mcp.mount()
if __name__ == "__main__":
    uvicorn.run(app, host="0.0.0.0", port=8000)

class FastApiMCP:
    """
    Create an MCP server from a FastAPI app.
    """
    
    def __init__(
        self,
        fastapi: Annotated[
            FastAPI,
            Doc("The FastAPI application to create an MCP server from"),
        ],
        name: Annotated[
            Optional[str],
            Doc("Name for the MCP server (defaults to app.title)"),
        ] = None,
        description: Annotated[
            Optional[str],
            Doc("Description for the MCP server (defaults to app.description)"),
        ] = None,
        describe_all_responses: Annotated[
            bool,
            Doc("Whether to include all possible response schemas in tool descriptions"),
        ] = False,
        describe_full_response_schema: Annotated[
            bool,
            Doc("Whether to include full json schema for responses in tool descriptions"),
        ] = False,
        http_client: Annotated[
            Optional[httpx.AsyncClient],
            Doc(
                """
                Optional custom HTTP client to use for API calls to the FastAPI app.
                Has to be an instance of `httpx.AsyncClient`.
                """
            ),
        ] = None,
        include_operations: Annotated[
            Optional[List[str]],
            Doc("List of operation IDs to include as MCP tools. Cannot be used with exclude_operations."),
        ] = None,
        exclude_operations: Annotated[
            Optional[List[str]],
            Doc("List of operation IDs to exclude from MCP tools. Cannot be used with include_operations."),
        ] = None,
        include_tags: Annotated[
            Optional[List[str]],
            Doc("List of tags to include as MCP tools. Cannot be used with exclude_tags."),
        ] = None,
        exclude_tags: Annotated[
            Optional[List[str]],
            Doc("List of tags to exclude from MCP tools. Cannot be used with include_tags."),
        ] = None,
        auth_config: Annotated[
            Optional[AuthConfig],
            Doc("Configuration for MCP authentication"),
        ] = None,
    ):
    ...

from fastapi import FastAPI
from fastapi_mcp import FastApiMCP
app = FastAPI()
mcp = FastApiMCP(
    app,
    name="My API MCP",
    description="Very cool MCP server",
    describe_all_responses=True,
    describe_full_response_schema=True
)
mcp.mount()

from fastapi import FastAPI
from fastapi_mcp import FastApiMCP
app = FastAPI()
# 案例1：include_operations
mcp = FastApiMCP(
    app,
    include_operations=["get_user", "create_user"]
)
# 案例2：exclude_operations
mcp = FastApiMCP(
    app,
    exclude_operations=["delete_user"]
)
# 案例3：include_tags
mcp = FastApiMCP(
    app,
    include_tags=["users", "public"]
)
#案例4：exclude_tags
mcp = FastApiMCP(
    app,
    exclude_tags=["admin", "internal"]
)
# 案例5：Combined
mcp = FastApiMCP(
    app,
    include_operations=["user_login"],
    include_tags=["public"]
)
mcp.mount()

# Auto-generated operation_id (something like "read_user_users__user_id__get")
@app.get("/users/{user_id}")
async def read_user(user_id: int):
    return {"user_id": user_id}
# Explicit operation_id (tool will be named "get_user_info")
@app.get("/users/{user_id}", operation_id="get_user_info")
async def read_user(user_id: int):
    return {"user_id": user_id}

python = "^3.12"
fastapi = "0.115.12"
fastapi-mcp ="0.3.1"
mcp="1.7.0"
pydantic = "^2.11.0"
pydantic-settings = "^2.2.0"

{
  "mcpServers": {
    "fastapi-mcp": {
      "url": "http://localhost:8022/mcp",
      "description": "本地开发环境MCP服务配置"
    },
    "tools-mcp": {
      "url": "http://localhost:8011/mcp",
      "description": "本地开发环境MCP服务配置"
    },    
    "demo-mcp": {
      "url": "http://localhost:8001/sse",
      "description": "本地开发环境MCP服务配置"
    },
    "tools-mcp-prod": {
      "url": "http://XXXXXX/mcp",
      "description": "线上"
    }
}
}

@router.post('/create-account', operation_id="create_account",summary="创建测试账号")
async def c_create_account(
        env: str = Body(..., description='环境'),
        phonenumber: str = Body(..., description='手机号'),
        pwd: str = Body(..., description='密码'),
        usernum: str = Body(None, description='数量'),
) -> Any:
    """
    创建测试账号，默认111开头
   
    args
        env: 环境，默认：t1
        phonenumber: 手机号
        pwd: 密码，默认：test123
        usernum: 数量
    """
   

"""
创建测试账号，默认111开头，不用填写111，只需要后面8位
不传手机号phonenumber，默认随机生成手机号
args
    env: 环境，默认：t1
    phonenumber: 手机号，非必填，不填自动生成
    pwd: 密码，默认：test123
    usernum: 数量
"""

阅读原文

跳转微信打开

Fish AI Reader

Fish AI Reader

AI辅助创作，多种专业模板，深度分析，高质量内容生成。从观点提取到深度思考，FishAI为您提供全方位的创作支持。新版本引入自定义参数，让您的创作更加个性化和精准。

FishAI

鱼阅，AI 时代的下一个智能信息助手，助你摆脱信息焦虑

联系邮箱 441953276@qq.com