Weights And Measures MCP Server

🚀 度量衡MCP服务器

本项目是一个模型上下文协议（MCP）服务器，为度量衡转换提供工具和资源。该服务器能让AI助手进行精确的单位转换，并访问不同度量系统的综合参考表。

✨ 主要特性

工具

1. convert_unit - 在不同计量单位之间转换数值

   • 支持重量转换（常衡制、金衡制、药衡制、公制）
   • 支持长度转换（英制/美制、公制）
   • 支持体积转换（美制液量、英制液量、公制）
   • 示例：将10磅转换为千克，或将5英里转换为千米

2. get_conversion_factor - 获取两个单位之间的转换乘数

   • 返回从一个单位转换到另一个单位所需的精确系数
   • 有助于理解转换关系
   • 示例：获取将金衡盎司转换为克的系数

3. list_units - 列出所有可用单位，可按类别筛选

   • 查看所有支持的单位
   • 按类别筛选：重量、长度或体积
   • 有助于发现可用的转换选项

资源

可访问不同度量系统的综合参考表：

重量表：

• weights://tables/avoirdupois - 商业重量（磅、盎司、格令）
• weights://tables/troy - 贵金属重量（金衡盎司、本尼威特）
• weights://tables/apothecaries - 药剂师重量（打兰、吩）
• weights://tables/metric-weight - 公制重量（千克、克）
• weights://tables/cross-system-weight - 跨系统转换

长度表：

• length://tables/imperial-us - 英制/美制长度（英里、码、英尺、英寸）
• length://tables/metric - 公制长度（千米、米、厘米）
• length://tables/cross-system - 英制/公制转换

体积表：

• volume://tables/us-fluid - 美制液量（加仑、夸脱、品脱、杯）
• volume://tables/imperial-fluid - 英制液量
• volume://tables/metric-volume - 公制体积（升、毫升）
• volume://tables/cross-system-volume - 跨系统转换

其他：

• units://all - 所有支持单位的完整列表

📦 安装指南

前提条件

• Python 3.10 或更高版本
• uv 包管理器

安装依赖项

# 克隆仓库
git clone https://github.com/yourusername/weights-and-measures-mcp-server.git
cd weights-and-measures-mcp-server

# 使用uv安装依赖项
uv sync

💻 使用示例

与Claude桌面版配合使用

将以下配置添加到Claude桌面版的配置文件中：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "weights-and-measures": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/weights-and-measures-mcp-server",
        "run",
        "weights-and-measures-server"
      ]
    }
  }
}

将 /ABSOLUTE/PATH/TO/ 替换为你克隆仓库的实际路径。

独立运行

直接运行服务器：

uv run weights-and-measures-server

或者使用Python运行：

python -m weights_and_measures_server.server

基础用法

连接到MCP客户端（如Claude桌面版）后，你可以：

• 转换单位：
  • “将10磅转换为千克”
  • “5加仑等于多少升？”
  • “将100英里转换为千米”
• 获取转换系数：
  • “金衡盎司到克的转换系数是多少？”
  • “如何将英尺转换为米？”
• 访问参考表：
  • “给我看看常衡制重量表”
  • “公制长度单位有哪些？”
  • “列出所有可用的体积单位”

📚 详细文档

支持的单位

重量：

• 常衡制：长吨、短吨、磅、盎司、格令
• 金衡制：金衡磅、金衡盎司、本尼威特、金衡格令
• 药衡制：药衡磅、药衡盎司、打兰、吩、药衡格令
• 公制：公吨、千克、克、分克、厘克、毫克

长度：

• 英制/美制：英里、码、英尺、英寸
• 公制：千米、米、分米、厘米、毫米

体积：

• 美制液量：美制加仑、加仑、夸脱、品脱、液量盎司、杯、汤匙、茶匙
• 英制：英制加仑、英制夸脱、英制品脱、英制液量盎司
• 公制：立方米、升、分升、厘升、毫升
• 立方单位：立方英寸、立方英尺

项目结构

weights-and-measures-mcp-server/
├── weights_and_measures_server/
│   ├── __init__.py
│   ├── server.py          # MCP服务器实现
│   └── data.py            # 转换系数和参考表
├── pyproject.toml         # 项目配置
├── test_server.py         # 测试套件
└── README.md