Remote MCP Server Testing

MCP演示项目

这个项目展示了如何建立和运行一个 MCP（模型上下文协议）服务器 使用 FastMCP 和 紫外线.

______________________________________________________________________

先决条件

• Python 3.11+
• uv 命令行界面（CLI）工具
• fastmcp Python包
• GitHub账户（用于存储库）
• FastMCP 云账户（免费版）

______________________________________________________________________

安装说明

1. 使用（以下工具或命令）初始化项目 uv

   pip install uv
   uv init .

1. 将FastMCP添加到项目中

   uv add fastmcp

1. 创建您的MCP服务器文件 （例如。， main.py）

   from fastmcp import FastMCP

   mcp = FastMCP("DemoServer")

   @mcp.tool
   def add(a: int, b: int) -> int:
       return a + b

   if __name__ == "__main__":
       mcp.run() 
       * To run MCP server locally. Default is to run locally
       mcp.run(transport="http",host="0.0.0.0",port=8000)
       * To run MCP server on FastMCP Cloud.

1. 在本地启动MCP服务器

   uv run fastmcp run main.py

启动远程MCP服务器

   fastmcp run main.py --transport http --host 0.0.0.0 --port

                              or 

   uv run main.py

1. 使用MCP Inspector测试服务器

   uv run fastmcp dev main.py

- 允许您在本地测试和检查MCP工具（类似于Postman）。

______________________________________________________________________

在FastMCP云上部署MCP服务器作为远程服务器

1. 创建一个GitHub仓库 为你的项目进行（相关操作）并推送你的代码。

1. 创建一个FastMCP云账户 （免费套餐可用，详情请访问 FastMCP Cloud（可译为“FastMCP云”或根据具体语境简化为“FastMCP云端”）)。

1. 在云端安装项目依赖项

   uv add .
   uv add fastmcp

1. 部署您的MCP服务器

   uv run fastmcp deploy main.py --cloud

1. 测试已部署的服务器 使用MCP Inspector或通过您的云URL。

______________________________________________________________________

1. 将MCP服务器与Claude桌面集成

PowerShell 运行 UV，使用 fastmcp 安装 claude-desktop，执行 main.py

• 将MCP服务器与Claude Desktop集成起来非常简单。

在本地使用代理服务器/远程MCP服务器

你可以连接到一个 远程MCP服务器 使用代理在本地访问MCP工具。这对于测试云部署的MCP服务器或在远程环境中运行您的服务器非常有用。

步骤

1. 确保您的远程MCP服务器已部署且可访问（例如，通过 FastMCP 云）。
2. 使用 as_proxy 在本地环境中创建代理客户端的方法。

示例：使用 as_proxy 方法

from fastmcp import FastMCP

# Connect to the remote MCP server using proxy
mcp = FastMCP.as_proxy("https://your-remote-mcp-server.fastmcp.ai")

# Call remote MCP tools as if they were local
result = mcp.add_expense(item="Lunch", amount=12.5, category="Food")
print(result)

summary = mcp.expense_summary()
print(summary)

这种设置使您能够无缝地与远程MCP服务器进行交互，因为

项目结构

MCP Demo Project/
├─ main.py          # MCP server code
├─ uv.yaml          # Project config (generated by uv)
├─ README.md        # Project documentation
└─ .venv/           # Project virtual environment (managed by uv)

______________________________________________________________________

注释

• 使用 uv run fastmcp dev main.py 用于开发和测试。
• 使用 uv run fastmcp run main.py 用于在本地运行生产MCP服务器。
• 使用FastMCP云进行部署 uv run fastmcp deploy main.py --cloud。
• 所有MCP工具均定义在 main.py 在……之下 @mcp.tool 装饰器。