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 开源计划的一部分。