PCCES MCP Server

台灣公共工程經費電腦估價系統（PCCES）的 MCP (Model Context Protocol) 伺服器。

讓 Claude Desktop 等 AI 助理能直接查詢 PCCES 資料庫，包含專案工項、標準資源代碼（L/E 人力機具）、工項代碼解碼等功能。

系統需求

重要：本工具僅適用於已安裝 PCCES 軟體的 Windows 電腦，需能存取 PCCES 的 SQL Server 資料庫。

Related MCP server: Healthcare OpenData MCP

安裝步驟

1. 下載專案

git clone https://github.com/manosaki/pcces-mcp-server.git

或直接下載 ZIP 並解壓縮到任意目錄（建議 C:\pcces-mcp-server）。

2. 執行安裝程式（建議）

進入專案目錄，雙擊執行 install.bat。

安裝程式會自動：

• 偵測電腦上正確的 Python 版本（處理多版本共存問題）

• 安裝必要套件（mcp、pyodbc）

• 驗證 PCCES 資料庫連線

• 顯示 Claude Desktop 設定內容（直接複製貼上即可）

3. 設定 Claude Desktop

開啟設定檔（按 Win + R，輸入 %APPDATA%\Claude，用記事本開啟 claude_desktop_config.json）。

將 install.bat 輸出的設定內容貼入存檔，例如：

{
  "mcpServers": {
    "pcces": {
      "command": "C:\\Users\\USER\\AppData\\Local\\Programs\\Python\\Python312\\python.exe",
      "args": ["C:\\pcces-mcp-server\\server.py"]
    }
  }
}

注意：command 必須使用 install.bat 輸出的完整 Python 路徑，不可直接填 python（多版本環境下會指到錯誤的版本）。

4. 重新啟動 Claude Desktop

關閉並重新開啟 Claude Desktop，在工具清單中確認出現 pcces 相關工具即完成設定。

手動安裝（進階）

若不使用 install.bat，請手動執行：

# 確認 Python 版本（需 3.10+）
python --version

# 若系統有多個 Python，使用 py 啟動器指定版本
py -3.12 -m pip install -r requirements.txt

# 查詢實際 Python 路徑（貼入 claude_desktop_config.json）
py -3.12 -c "import sys; print(sys.executable)"

進階設定

環境變數

在 claude_desktop_config.json 中設定環境變數：

{
  "mcpServers": {
    "pcces": {
      "command": "C:\\Users\\USER\\AppData\\Local\\Programs\\Python\\Python312\\python.exe",
      "args": ["C:\\pcces-mcp-server\\server.py"],
      "env": {
        "PCCES_SQL_SERVER": ".\\SQLEXPRESS2019"
      }
    }
  }
}

提供工具清單

使用範例

安裝完成後，可在 Claude Desktop 直接用中文提問：

• 「列出所有可用的 PCCES 資料庫」

• 「幫我找 AR 資料庫中含有混凝土的工項」

• 「解碼工項代碼 0225340004 是什麼意思」

• 「建築師的人力資源代碼是什麼？單位為月」

• 「找出救險吊車，3噸的機具代碼」

常見問題

Q：執行 install.bat 顯示找不到 Python

請先安裝 Python 3.10+：前往 https://www.python.org/downloads/ 下載，安裝時勾選「Add Python to PATH」及「pip」。

Q：連線失敗，找不到資料庫

1. 確認 PCCES 軟體已正常安裝

2. 確認 SQL Server Express 服務正在執行（工作管理員→服務→MSSQL$SQLEXPRESS）

3. 若執行個體名稱不同，在 claude_desktop_config.json 加入 "env": {"PCCES_SQL_SERVER": ".\\你的執行個體名稱"}

Q：Claude Desktop 看不到 pcces 工具

1. 確認 claude_desktop_config.json 的 Python 路徑正確（使用 install.bat 輸出的完整路徑）

2. 完整關閉並重新開啟 Claude Desktop

授權

MIT License