FANUC 0i-F Plus Parameters MCP Server

這是一個可直接執行的 Python MCP Server，包含目前對話中整理的 FANUC 參數： 1660、1735、1769、1783、19539。

資料完整性說明：目前工作區沒有原始 PDF 或先前產生的 JSON，因此專案只保留 對話中已明確整理的內容；資料型態、單位、範圍、頁碼等未確認欄位為 null。 19539 明確保留為 unresolved，沒有推測或補寫定義。

需求

• Python 3.10 或更新版本

安裝

Windows PowerShell：

cd fanuc-mcp-server
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt

macOS / Linux：

cd fanuc-mcp-server
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

執行

伺服器使用 stdio transport：

python server.py

直接執行時等待 MCP Client 從標準輸入連線是正常行為。

MCP Client 設定

mcp.json 提供從專案目錄啟動的範例。若 Client 不支援 cwd，請把 args 中的 server.py 改成其絕對路徑；建議也改用虛擬環境內 Python 的絕對路徑。

{
  "mcpServers": {
    "fanuc-parameters": {
      "command": "C:\\完整路徑\\fanuc-mcp-server\\.venv\\Scripts\\python.exe",
      "args": ["C:\\完整路徑\\fanuc-mcp-server\\server.py"]
    }
  }
}

提供的 Tools

• get_fanuc_parameter(parameter_no)：取得單一參數

• list_fanuc_parameters(include_unresolved=true)：列出參數

• search_fanuc_parameters(query, include_unresolved=true)：文字搜尋

• compare_fanuc_parameters(parameter_numbers)：比較多個參數

範例提問：

• 請查詢 FANUC 1769

• 比較 FANUC 1660、1735、1769

• 搜尋「時間常數」

• 19539 的解析狀態是什麼？

提供的 Resources

• fanuc://manuals/b64700ct-01

• fanuc://parameters/{parameter_no}

測試

在專案根目錄執行：

python -m unittest discover -s tests -v

測試會確認：

• 恰好包含 5 個指定參數

• 19539 保持 unresolved 且沒有名稱或摘要

• 關鍵字搜尋正常

• 每筆 JSONL 都符合 JSON Schema

也可用官方 MCP Inspector 做互動測試（需要 Node.js）：

npx -y @modelcontextprotocol/inspector python server.py

專案結構

fanuc-mcp-server/
├── data/
│   └── fanuc_parameters.jsonl
├── schema/
│   └── parameter.schema.json
├── tests/
│   ├── test_repository.py
│   └── test_schema.py
├── repository.py
├── resources.py
├── tools.py
├── server.py
├── requirements.txt
├── mcp.json
└── README.md

後續擴充

新增資料時，每行加入一個符合 schema/parameter.schema.json 的 JSON 物件，然後重新 執行測試。對尚未從手冊確認的參數，請使用 status: "unresolved" 並保留未知欄位為 null。

FANUC_MCP