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