AI导哈

数学计算服务器

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

  • by K-Summer
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 K-Summer/Math_MCPS

使用说明

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 协议提供数学计算服务

相关 MCP