huayi-mcp 0.1.9

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，适用于实时推送场景

项目结构

huayi-mcp-py/
├── huayi_mcp_server/
│   ├── __init__.py
│   ├── __main__.py          # 入口文件
│   ├── server.py            # MCP 服务器入口
│   ├── tools.py             # MCP tools 实现
│   └── sdk/
│       ├── __init__.py      # SDK 基类
│       ├── huajitong.py     # 华集通 API 客户端
│       └── models.py        # 数据模型定义
├── pyproject.toml           # 项目配置和依赖
├── Makefile                 # 开发命令快捷方式
└── README.MD               # 项目说明文档

开发环境设置

环境要求

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

安装依赖

# 使用 uv 安装依赖
uv sync

环境变量配置

需要配置以下环境变量：

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

开发和运行

使用 Makefile（推荐）

# 以 stdio 模式运行（用于本地开发和测试）
make dev-stdio

# 以 streamable-http 模式运行（用于 HTTP 服务）
make dev-streamable

# 以 SSE 模式运行（用于事件推送）
make dev-sse

开发指南

添加新功能

略

代码规范

项目使用以下工具确保代码质量：

• Ruff：代码格式化和 lint 检查
• Pyright：类型检查
• Pytest：单元测试

# 代码格式化
uv run ruff format .

# Lint 检查
uv run ruff check .

# 类型检查
uv run pyright

# 运行测试
uv run pytest

技术栈

• 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.6",
        "mcp-server"
      ],
      "env": {
        "BASE_URL": "http://your-domain",
        "HUAJITONG_SECRET": "your-secret"
      }
    }
  }
}

许可证

本项目仅供内部使用。

作者

• Chen Zhongrun

版本历史

• 0.1.8：当前版本，支持用户自配送次数查询