Forge MCP

🚀 Tyler Forge™ MCP Server

Tyler Forge™ MCP Server 可讓您在 AI 客戶端中直接訪問 Tyler Forge™ 網絡組件文檔。您可以在此提問、生成代碼示例並探索設計系統的詳細信息。

✨ 主要特性

Tyler Forge™ 是 Tyler Technologies 全面的網絡組件庫和設計系統。此工具將相關文檔集成到您的 AI 工具中，讓您能夠：

• 發現組件 - 找到滿足您需求的合適組件。
• 生成代碼 - 獲取特定框架（Angular、React、Vue、Svelte）的示例代碼。
• 驗證 API - 驗證組件屬性、特性、事件和其他 API 是否正確使用。
• 訪問設計令牌 - 一致地使用顏色、間距和排版樣式。
• 學習最佳實踐 - 獲取實現指南和可訪問性提示。

🚀 快速開始

它是如何工作的？

此 MCP 服務器提供了一組聲明性資源和工具，用於訪問 Tyler Forge 文檔。它採用漸進式披露模型，在最大程度提高準確性的同時降低複雜性。

上下文感知

當您在 AI 客戶端中啟動 MCP 服務器時，它會自動檢測您項目中當前安裝的 Tyler Forge 版本（如果有）。這使它能夠提供特定版本的文檔。如果未檢測到版本，它將默認使用此 MCP 服務器中捆綁的最新穩定版本。

漸進式披露

MCP 服務器的設計旨在通過預先僅展示最基本的資源和工具來減輕認知負擔。更詳細的信息可以通過特定工具或後續查詢獲取。這在控制令牌使用的同時，仍能在需要時提供對文檔的全面訪問。

文檔來源

所有文檔均從每個 Tyler Forge 軟件包中包含的自定義元素清單（CEM）文件中提取，以及從文檔網站 https://forge.tylerdev.io 獲取的信息。

安裝設置

Claude Code

claude mcp add -t stdio -s [scope] forge -- npx -y @tylertech/forge-mcp@latest

[scope] 必須為 user、project 或 local。有關更多信息，請參閱 Claude Code MCP 文檔。

Codex CLI

將以下內容添加到您的 config.toml 文件中（默認路徑為 ~/.codex/config.toml，但對於更高級的設置，請參考配置文檔）：

[mcp_servers.forge]
command = "npx"
args = ["-y", "@tylertech/forge-mcp@latest"]

Gemini CLI

gemini mcp add -t stdio -s [scope] forge npx -y @tylertech/forge-mcp@latest

[scope] 必須為 user、project 或 local。

VS Code

• 打開命令面板（Cmd+Shift+P 或 Ctrl+Shift+P）。
• 選擇 MCP: Add Server...。
• 選擇 Command (stdio)。
• 輸入 npx -y @tylertech/forge-mcp@latest。
• 將服務器命名為 forge。
• 選擇是否將其用作 Global 或 Workspace MCP 服務器。

有關更多信息，請參閱 VS Code MCP 文檔。

手動配置

將 Forge MCP 服務器添加到您項目的 .vscode/mcp.json 配置文件中，或者使用命令面板通過 “MCP: Add Server...” 進行添加。

{
  "servers": {
    "forge": {
      "command": "npx",
      "args": ["-y", "@tylertech/forge-mcp@latest"],
      "type": "stdio"
    }
  }
}

注意：將服務器添加到配置文件後，您可能需要手動啟動它。使用命令面板中的 MCP: List Servers 命令。

Claude Desktop

• 打開 Settings。
• 選擇 Developer。
• 點擊 Edit Config。

這將在文件資源管理器中打開 claude_desktop_config.json 文件所在的目錄。編輯該文件以包含以下配置：

{
  "mcpServers": {
    "forge": {
      "command": "npx",
      "args": ["-y", "@tylertech/forge-mcp@latest"]
    }
  }
}

使用最佳實踐

使用任何 AI 工具時，遵循最佳實踐以確保有效使用和準確結果非常重要：

• 明確具體：清晰定義您的問題或請求，以獲取最相關的信息。使用模糊的提示可能會導致不準確或錯誤的響應。
• 提前規劃：花時間規劃和組織您的提示，並將任務分解為更小的部分。這可以顯著提高響應的質量。
• 驗證信息：始終與官方文檔或可靠來源交叉核對關鍵信息。AI 輸出可能並不總是準確的。
• 提供上下文：編寫提示時，提供相關上下文以幫助 AI 更好地理解您的需求。
• 使用示例：儘可能提供您所需內容的示例或截圖，以引導 AI 的響應。
• 限制範圍：將複雜的查詢分解為更小、可管理的部分，以提高清晰度和響應質量。對於長時間的對話，定期壓縮或清除上下文以保持相關性。

如果只能記住一點，那就是要明確具體，並提前花時間規劃和組織您的提示。這將帶來更準確和有用的結果。最後，請記住，這些工具是為了協助您，但即使使用最佳的提示和上下文，它們也可能出錯。始終驗證和審查輸出的準確性。

⚠️ 重要提示

始終驗證任何 AI 工具的輸出準確性。雖然此 MCP 服務器旨在提供準確的信息，但它可能並不總是完美的，而且大語言模型有時會產生幻覺。始終與官方 Tyler Forge™ 文檔或可靠來源交叉核對關鍵信息。

🔧 技術細節

功能提示

forge_mode

在運行特定於 Forge 的任務/查詢時設置一些基本規則。

您可以在 AI 客戶端中通過指定提示名稱（如果支持）觸發此提示，通常通過斜槓命令或提示選擇。forge_mode 提示接受一個 task 參數，您可以在其中描述您的特定任務/查詢。這有助於引導大語言模型使用正確的 MCP 服務器工具，並在輸出與 Tyler Forge 相關的代碼時包含一些規則和最佳實踐。

工具

以下工具可用於與 Tyler Forge 文檔進行交互。每個工具都使用聲明性參數，在為 AI 客戶端減輕認知負擔的同時提供全面的功能：

資源

以下 簡化資源 可通過漸進式披露模型進行參考：

注意：為降低複雜性，已移除了細粒度的組件資源（/properties、/methods、/events 等）。使用 工具 來細粒度訪問特定組件信息。

開發命令

pnpm run dev    # 監聽模式
pnpm run debug  # 使用 MCP 檢查器進行測試
pnpm run build  # 構建生產版本

🤝 貢獻

歡迎貢獻！有關詳細信息，請參閱 貢獻指南。

如果您發現任何問題或有改進建議，請提交問題或拉取請求。

📄 許可證

本項目採用 Apache-2.0 許可證 - 有關詳細信息，請參閱 LICENSE 文件。

本項目是 Tyler Technologies 開源計劃的一部分。