分布式 MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供用于法律信息查询、天气数据、Azure 定价和实用函数的工具接口。

概述

此服务器提供可供 Microsoft Copilot 或其他支持 MCP 协议的 AI 助手使用的 API 工具：

法律信息工具

• 获取文章信息: 按代码查询中国刑法条文
• 内容搜索: 通过关键词查找相关的刑法条文
• 文章名称查询: 通过文章或罪名查找法律信息
• 特定段落检索: 从文章中获取特定段落
• 获取完整内容: 获取中国刑法的完整内容

天气和实用工具

• 天气警报: 获取美国州的天气警报
• 天气预报: 使用经纬度获取天气预报
• Azure 价格查询: 使用 OData 过滤器查询 Azure 服务价格
• 汉字计数: 统计文本中的汉字数量

技术栈

• FastMCP 框架，用于 MCP 协议支持
• Uvicorn ASGI 服务器
• FastAPI/Starlette Web 框架
• SSE (服务器发送事件) 用于通信

要求

• Python 3.10 或更高版本
• Docker (可选，用于容器化部署)

安装

本地开发:

1. 克隆存储库:

   git clone <repository-url>
   cd mcp-server
   

2. 创建并激活虚拟环境:

   python -m venv venv
   source venv/bin/activate  # Windows: venv\Scripts\activate
   

3. 安装依赖项:

   pip install -r requirements.txt
   

部署 Azure 函数

对于汉字计数功能：

1. 在 VSCode 中打开函数目录：

   cd function
   

2. 使用 Azure Functions 扩展进行部署

用法

启动服务器

python mcp-server.py --host 0.0.0.0 --port 8080

服务器将在 http://localhost:8080 运行。

可用端点

• /sse - 服务器发送事件端点
• /messages/ - MCP 消息处理端点

工具使用示例

# 查询刑法
请查找刑法第 133 条。

# 查询天气
纽约州有天气警报吗？

# 统计汉字数量
以下内容有多少个汉字：人工智能正在改变我们的生活方式。

Docker 设置

构建镜像

docker build -t mcp-server .

运行容器

docker run -p 8080:8080 --env-file .env mcp-server

Azure 部署选项

1. Azure 容器注册表 (ACR)

az login
az group create --name myResourceGroup --location eastasia
az acr create --resource-group myResourceGroup --name myacrregistry --sku Basic
az acr login --name myacrregistry
docker tag mcp-server myacrregistry.azurecr.io/mcp-server:latest
docker push myacrregistry.azurecr.io/mcp-server:latest

2. Azure 容器应用

az containerapp env create \
  --name my-environment \
  --resource-group myResourceGroup \
  --location eastasia

az containerapp create \
  --name mcp-server-app \
  --resource-group myResourceGroup \
  --environment my-environment \
  --image myacrregistry.azurecr.io/mcp-server:latest \
  --registry-server myacrregistry.azurecr.io \
  --target-port 8080 \
  --ingress external \
  --env-vars MONGODB_CONNECTION_STRING=secretref:mongodbconnection \
             AZURE_OPENAI_API_KEY=secretref:azureopenaikey

3. Azure Web 应用

az appservice plan create --name myAppServicePlan \
  --resource-group myResourceGroup \
  --sku B1 \
  --is-linux

az webapp create \
  --resource-group myResourceGroup \
  --plan myAppServicePlan \
  --name my-mcp-server-app \
  --deployment-container-image-name myacrregistry.azurecr.io/mcp-server:latest

az webapp config appsettings set \
  --resource-group myResourceGroup \
  --name my-mcp-server-app \
  --settings MONGODB_CONNECTION_STRING=your_mongodb_connection_string \
             AZURE_OPENAI_API_KEY=your_azure_openai_api_key

az webapp config container set \
  --resource-group myResourceGroup \
  --name my-mcp-server-app \
  --docker-registry-server-url https://myacrregistry.azurecr.io \
  --docker-custom-image-name myacrregistry.azurecr.io/mcp-server:latest

CI/CD

此项目使用 GitHub Actions 构建 Docker 镜像并将其发布到 Azure 容器注册表。 有关详细信息，请参见 .github/workflows/action-to-acr.yml。

推荐架构

对于生产环境：

1. 部署到 Azure 容器应用以实现自动缩放
2. 单独部署 Azure 函数
3. 使用 Application Insights 进行监控
4. 使用 Azure Front Door 进行 CDN 和安全性

添加新工具

@mcp.tool()
async def my_new_tool(param1: str, param2: int = None) -> str:
    """工具描述.
  
    Args:
        param1: 参数 1 的描述
        param2: 参数 2 的描述
    """
    try:
        # 你的代码在这里
        return "Result"
    except Exception as e:
        return f"Error: {str(e)}"

故障排除

数据库问题

• 验证 MongoDB 连接字符串格式
• 对于 Cosmos DB，确保向量搜索支持

Azure OpenAI 问题

• 检查 API 密钥和端点
• 验证模型部署名称

查看日志

# 容器应用日志
az containerapp logs show --name mcp-server-app --resource-group myResourceGroup
# Web 应用日志
az webapp log tail --name my-mcp-server-app --resource-group myResourceGroup
# 函数日志
az functionapp log tail --name haxufunctions --resource-group myResourceGroup

安全最佳实践

1. 将凭据存储在 Azure Key Vault 中
2. 配置正确的 API 身份验证
3. 保持依赖项更新
4. 启用诊断日志
5. 对服务标识使用最小权限原则

参考

• 模型上下文协议
• FastMCP
• Azure 容器应用
• Azure 函数
• Azure Cosmos DB