分布式MCP Server

分布式MCP Server

xuhaoruins

研究与数据
访问服务器

README

分布式 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. 对服务标识使用最小权限原则

参考

推荐服务器

Crypto Price & Market Analysis MCP Server

Crypto Price & Market Analysis MCP Server

一个模型上下文协议 (MCP) 服务器,它使用 CoinCap API 提供全面的加密货币分析。该服务器通过一个易于使用的界面提供实时价格数据、市场分析和历史趋势。 (Alternative, slightly more formal and technical translation): 一个模型上下文协议 (MCP) 服务器,利用 CoinCap API 提供全面的加密货币分析服务。该服务器通过用户友好的界面,提供实时价格数据、市场分析以及历史趋势数据。

精选
TypeScript
MCP PubMed Search

MCP PubMed Search

用于搜索 PubMed 的服务器(PubMed 是一个免费的在线数据库,用户可以在其中搜索生物医学和生命科学文献)。 我是在 MCP 发布当天创建的,但当时正在度假。 我看到有人在您的数据库中发布了类似的服务器,但还是决定发布我的服务器。

精选
Python
mixpanel

mixpanel

连接到您的 Mixpanel 数据。 从 Mixpanel 分析查询事件、留存和漏斗数据。

精选
TypeScript
Sequential Thinking MCP Server

Sequential Thinking MCP Server

这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决,支持修订,并通过完整的 MCP 集成来实现多条解决方案路径。

精选
Python
Nefino MCP Server

Nefino MCP Server

为大型语言模型提供访问德国可再生能源项目新闻和信息的能力,允许按地点、主题(太阳能、风能、氢能)和日期范围进行筛选。

官方
Python
Vectorize

Vectorize

将 MCP 服务器向量化以实现高级检索、私有深度研究、Anything-to-Markdown 文件提取和文本分块。

官方
JavaScript
Mathematica Documentation MCP server

Mathematica Documentation MCP server

一个服务器,通过 FastMCP 提供对 Mathematica 文档的访问,使用户能够从 Wolfram Mathematica 检索函数文档和列出软件包符号。

本地
Python
kb-mcp-server

kb-mcp-server

一个 MCP 服务器,旨在实现便携性、本地化、简易性和便利性,以支持对 txtai “all in one” 嵌入数据库进行基于语义/图的检索。任何 tar.gz 格式的 txtai 嵌入数据库都可以被加载。

本地
Python
Research MCP Server

Research MCP Server

这个服务器用作 MCP 服务器,与 Notion 交互以检索和创建调查数据,并与 Claude Desktop Client 集成以进行和审查调查。

本地
Python
Cryo MCP Server

Cryo MCP Server

一个API服务器,实现了模型补全协议(MCP),用于Cryo区块链数据提取,允许用户通过任何兼容MCP的客户端查询以太坊区块链数据。

本地
Python