Math_MCPS 项目文件描述

项目概述

Math_MCPS 是一个基于 Model Context Protocol (MCP) 的数学计算服务器，提供丰富的数学计算功能，包括基础运算、高级数学函数、统计学工具、数学常量资源和复杂算式处理能力。

文件结构

Math_MCPS/
├── .gitignore              # Git 忽略文件配置
├── .python-version        # Python 版本要求 (>=3.12)
├── main.py                # 主程序文件，包含所有数学工具和资源
├── pyproject.toml         # 项目配置文件，定义依赖和元数据
├── README.md              # 项目文档，包含功能介绍和使用方法
├── uv.lock                # UV 依赖锁定文件
└── cute_message.txt       # 示例文件，包含可爱消息

核心文件详解

1. main.py - 主程序文件

功能：实现所有数学计算工具和资源的核心代码

主要组件：

• 基础数学运算：加、减、乘、除
• 高级数学运算：幂运算、根运算、对数、指数、三角函数、反三角函数
• 组合数学：阶乘、组合数、排列数
• 统计学工具：平均值、中位数、众数、方差、标准差
• 数学常量资源：π、e、黄金比例、根号2
• 复杂算式处理：表达式计算、表达式简化
• 提示生成器：解方程、证明定理、创建图形的提示模板
• 单位转换：角度单位转换

技术特点：

• 使用 FastMCP 框架构建服务器
• 支持类型提示，提高代码可读性
• 包含完整的错误处理机制
• 安全的数学表达式计算

2. pyproject.toml - 项目配置文件

功能：定义项目元数据和依赖关系

关键配置：

• 项目名称：math
• 版本：0.1.0
• Python 版本要求：>=3.12
• 主要依赖：mcp[cli]>=1.26.0
• 使用 UV 作为包管理器
• 配置清华源为默认 PyPI 源

3. README.md - 项目文档

功能：提供项目概述、功能介绍和使用指南

内容概览：

• 功能特性分类介绍
• 安装和运行说明
• 使用示例
• 扩展功能指导
• 注意事项和错误处理
• 测试方法

4. .gitignore - Git 忽略配置

功能：指定 Git 版本控制系统应忽略的文件

包含内容：

• Python 生成的文件 (pycache, *.pyo, *.pyd)
• 构建和分发目录 (build/, dist/, wheels/)
• 虚拟环境 (.venv)
• 项目特定的测试和调试文件

5. .python-version - Python 版本要求

功能：指定项目所需的 Python 版本

当前设置：>=3.12

6. uv.lock - 依赖锁定文件

功能：锁定项目依赖的确切版本，确保环境一致性

7. cute_message.txt - 示例文件

功能：包含一个可爱消息的示例文件，用于测试提交和推送功能

技术栈

• 编程语言：Python 3.12+
• 框架：MCP (Model Context Protocol) with FastMCP
• 包管理器：UV
• 版本控制：Git
• 密钥管理：GPG 签名验证

特色功能

1. 全面的数学工具集：从基础运算到高级数学函数
2. 安全表达式计算：支持复杂数学表达式的安全计算
3. 资源访问：提供数学常量的结构化访问
4. 提示生成：为数学问题提供解题思路和证明方法
5. 错误处理：完善的边界条件检查和错误提示
6. 类型安全：使用 Python 类型提示确保接口一致性

开发状态

• 项目已完成基本功能开发
• 配置了 GPG 签名验证
• 支持代码推送和版本控制
• 可以通过 MCP 协议提供数学计算服务