chuanglan-mcp-server

# 创蓝 253 MCP Server [](https://www.python.org/downloads/) [](https://opensource.org/licenses/MIT) [](https://modelscope.cn/) [](https://github.com/astral-sh/ruff) **创蓝 253 短信平台 MCP 服务器 - 企业级实现** 基于 FastMCP 框架构建，提供短信发送、余额查询、状态报告等功能的标准化 MCP 接口。 ## 特性 - 企业级代码质量 - 完整的类型注解 - Pydantic 数据验证 - 异步 I/O 支持 - 完善的错误处理 - 完整的测试覆盖 - 详细的文档 ## 快速开始 ### 1. 环境要求 - Python >= 3.10 - pip >= 21.0 ### 2. 安装依赖 ```bash pip install -r requirements.txt ``` ### 3. 配置 ```bash # 复制环境变量模板 cp .env.example .env # 编辑 .env 文件，填入创蓝账号信息 ``` ### 4. 运行 ```bash # 方式一：使用 uvicorn 运行 fastmcp run src/chuanglan_mcp/server.py # 方式二：直接运行 python -m chuanglan_mcp ``` ## 目录结构 ``` chuanglan-mcp/ ├── src/ │ └── chuanglan_mcp/ │ ├── __init__.py # 包初始化 │ ├── __main__.py # 入口点 │ ├── server.py # MCP 服务器定义 │ ├── client.py # 创蓝 API 客户端 │ ├── config.py # 配置管理 │ ├── models.py # 数据模型 │ └── exceptions.py # 自定义异常 ├── tests/ │ ├── __init__.py │ ├── conftest.py # pytest 配置 │ ├── test_client.py # 客户端测试 │ ├── test_server.py # 服务器测试 │ └── test_models.py # 模型测试 ├── examples/ │ ├── basic_usage.py # 基础使用示例 │ └── advanced_usage.py # 高级使用示例 ├── docs/ │ ├── api.md # API 文档 │ └── deployment.md # 部署文档 ├── scripts/ │ ├── lint.py # 代码检查 │ └── test.py # 运行测试 ├── .env.example # 环境变量示例 ├── .gitignore ├── LICENSE ├── README.md ├── README_EN.md # 英文文档 ├── pyproject.toml …