Forge MCP

🚀 Tyler Forge™ MCP Server

AIクライアント内で直接Tyler Forge™のウェブコンポーネントドキュメントにアクセスできます。質問をしたり、コード例を生成したり、デザインシステムの詳細を探索したりできます。

🚀 クイックスタート

利用できる機能

Tyler Forge™ はTyler Technologiesの包括的なウェブコンポーネントライブラリおよびデザインシステムです。このツールを使うと、以下のことができます。

• コンポーネントの探索 - 自分のニーズに合ったコンポーネントを見つける
• コードの生成 - フレームワーク固有のコード例（Angular、React、Vue、Svelte）を取得する
• APIの検証 - コンポーネントのプロパティ、属性、イベントなどのAPIが正しく使用されていることを確認する
• デザイントークンのアクセス - 色、スペーシング、タイポグラフィを一貫して使用する
• ベストプラクティスの学習 - 実装ガイダンスやアクセシビリティのヒントを取得する

動作原理

このMCPサーバーは、Tyler Forgeのドキュメントにアクセスするための一連の宣言的なリソースとツールを提供します。進行的開示モデルを使用して、複雑さを最小限に抑えながら精度を最大化します。

コンテキスト認識

AIクライアントでMCPサーバーを起動すると、自動的にプロジェクト内にインストールされているTyler Forgeのバージョン（あれば）を検出します。これにより、バージョン固有のドキュメントを提供できます。バージョンが検出されない場合は、このMCPサーバーにバンドルされている最新の安定リリースがデフォルトとなります。

進行的開示

MCPサーバーは、最初に最も重要なリソースとツールのみを公開することで、認知負荷を最小限に抑えるように設計されています。より詳細な情報は、特定のツールまたはフォローアップのクエリを通じてアクセスできます。これにより、トークンの使用をコントロールしながら、必要なときにドキュメントへの包括的なアクセスを提供します。

ドキュメントのソース

すべてのドキュメントは、各Tyler Forgeパッケージに含まれるCustom Elements Manifest（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サーバーは正確な情報を提供するように設計されていますが、必ずしも完全であるとは限らず、LLMは時々ハロウィングを起こすことが知られています。重要な情報は常に公式のTyler Forge™ドキュメントまたは信頼できるソースで照合してください。

✨ 主な機能

プロンプト

forge_mode

Forge固有のタスク/クエリを実行する際に、いくつかの基本ルールを設定します。

AIクライアントでは、サポートされている場合、通常はスラッシュコマンドまたはプロンプト選択を介して、プロンプト名を指定することでこのプロンプトをトリガーできます。forge_mode プロンプトは task パラメーターを受け取り、ここで特定のタスク/クエリを説明できます。これにより、LLMが正しいMCPサーバーツールを使用するようにガイドし、Tyler Forge関連のコードを出力する際のいくつかのルールとベストプラクティスを含めることができます。

ツール

Tyler Forgeのドキュメントとやり取りするために、以下のツールが利用可能です。各ツールは宣言的なパラメーターを使用して、AIクライアントの認知負荷を最小限に抑えながら包括的な機能を提供します。

リソース

以下の 簡素化されたリソース は、進行的開示モデルを介して参照できます。

注意: 細かいコンポーネントリソース（/properties、/methods、/events など）は、複雑さを減らすために削除されています。特定のコンポーネント情報に細かくアクセスするには、ツール を使用してください。

🔧 開発

コマンド:

pnpm run dev    # ウォッチモード
pnpm run debug  # MCPインスペクターでテスト
pnpm run build  # 本番用ビルド

🤝 コントリビューション

コントリビューションは大歓迎です！詳細については、CONTRIBUTING ガイドを参照してください。

問題を見つけた場合や改善提案がある場合は、イシューを開くか、プルリクエストを送信してください。

📄 ライセンス

Apache-2.0ライセンス - 詳細については、LICENSE ファイルを参照してください。

Tyler Technologies オープンソースイニシアチブの一部