huayi-mcp 0.1.10

Huayi MCP Servers

Huayi MCP Server

一个基于 Model Context Protocol (MCP) 的服务器项目，用于与花集通 API 进行交互，提供用户自配送次数查询等功能。

什么是 MCP？

Model Context Protocol (MCP) 是由 Anthropic 推出的开放协议，旨在标准化大语言模型（LLM）与外部数据源和工具的集成方式。

MCP 的核心概念

• 统一接口：为 LLM 提供标准化的方式来访问各种外部系统、数据库、API 和工具
• 客户端-服务器架构：MCP 服务器暴露功能（tools、resources、prompts），LLM 应用作为客户端调用
• 安全性：提供结构化的方式管理权限和数据访问
• 可扩展性：开发者可以创建自定义 MCP 服务器来集成任何外部系统

MCP 的优势

1. 减少重复开发：一次开发，多个 LLM 应用可复用
2. 标准化集成：遵循统一协议，降低集成复杂度
3. 增强 LLM 能力：让 LLM 可以访问实时数据、执行操作、调用外部服务

项目功能

本项目实现了一个 MCP 服务器，提供以下功能：

支持的传输协议

• stdio：标准输入输出，适用于本地集成
• streamable-http：流式 HTTP 传输，适用于 Web 服务
• sse：Server-Sent Events，适用于实时推送场景

开发环境设置

环境要求

• Python 3.13.0
• UV（Python 包管理工具）

安装依赖

# 使用 uv 安装依赖
uv sync

调试

需要配置以下环境变量：

export BASE_URL="http://your-domain"
export HUAJITONG_SECRET="your-secret"

使用 Makefile（推荐）

# 以 stdio 模式运行（用于本地开发和测试）
make BASE_URL=your-base-url HUAJITONG_SECRET=your-secret dev-stdio

# 以 streamable-http 模式运行（用于 HTTP 服务）
make BASE_URL=your-base-url HUAJITONG_SECRET=your-secret dev-streamable

# 以 SSE 模式运行（用于事件推送）
make BASE_URL=your-base-url HUAJITONG_SECRET=your-secret dev-sse

技术栈

• FastMCP：MCP 服务器框架
• Pydantic：数据验证和序列化
• httpx：HTTP 客户端
• Click：命令行界面
• Uvicorn/Starlette：ASGI 服务器（用于 HTTP 传输）

发布

构建项目

uv build

发布项目到 Pypi

uv publish --token 'your-pypi-token'

集成到 AI 应用

集成示例

在 LLM 应用中的配置文件中添加：

{
  "mcpServers": {
    "default-server": {
      "command": "uvx",
      "args": [
        "--from",
        "huayi-mcp@0.1.10",
        "mcp-server"
      ],
      "env": {
        "BASE_URL": "http://your-domain",
        "HUAJITONG_SECRET": "your-secret"
      }
    }
  }
}

许可证

本项目仅供内部使用。

作者

• Chen Zhongrun