MCP Roblox Docs

🚀 MCP Roblox Docs

このMCP（Model Context Protocol）サーバーは、Robloxエコシステムの包括的なドキュメントを提供します。AIアシスタントからAPIリファレンス、FastFlags、Open Cloud REST API、Luau言語ドキュメント、DevForumなどをクエリできます。

✨ 主な機能

• 常に最新: Robloxの公式ソースから自動的に同期します。
• 27の専用ツール: Robloxエコシステムを完全に網羅します。
• 全文検索: 850以上のクラス、35,000以上のメンバー、14,000以上のFastFlags、865のCloud APIエンドポイントを横断して検索できます。
• データ型とライブラリ: 44のデータ型（Vector3、CFrameなど）と11のLuau標準ライブラリをサポートします。
• 多言語対応: 英語、インドネシア語、日本語、韓国語、中国語など15の言語をサポートします。
• DevForum統合: インテリジェントキャッシュを使ってコミュニティの議論を検索できます。
• Open Cloud API: 認証、パラメータ、レスポンススキーマを含む完全なREST APIドキュメントを提供します。
• FastFlagsリファレンス: 14,000以上のエンジンフラグを検索および探索できます。
• Luau言語ドキュメント: 完全な言語リファレンスとグローバル変数を提供します。
• 無料: 100%無料で、APIキーは必要ありません。
• 最適化: 遅延読み込み、メモリ内キャッシュ、DevForum結果のキャッシュを行います。
• 高速同期: 並列ダウンロード（7 - 10倍高速）、リトライロジック、HTTP圧縮をサポートします。

📦 インストール

クイックスタート（推奨）

このMCPサーバーを使用する最も簡単な方法は、uvxを介することです。

uvx mcp-roblox-docs

インストールやセットアップは不要で、すぐに使えます！

ソースからのインストール

git clone https://github.com/nhattamgithub/mcp-roblox-docs
cd mcp-roblox-docs
uv sync
uv run mcp-roblox-docs

📚 詳細ドキュメント

Claude Desktop

Claude Desktopの設定に追加します。

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "roblox-docs": {
      "command": "uvx",
      "args": ["mcp-roblox-docs"]
    }
  }
}

Cursor / その他のMCPクライアント

{
  "mcpServers": {
    "roblox-docs": {
      "command": "uvx",
      "args": ["mcp-roblox-docs"]
    }
  }
}

または、ソースから実行する場合は以下のようにします。

{
  "command": "uv",
  "args": ["--directory", "/path/to/mcp-roblox-docs", "run", "mcp-roblox-docs"]
}

💻 使用例

APIの検索

User: How do I animate something smoothly?
AI: [uses roblox_search("tween animation")]
→ TweenService, TweenBase, Tween, EasingStyle...

クラス情報の取得

User: Tell me about TweenService
AI: [uses roblox_get_class("TweenService")]
→ Complete class info with Create(), GetValue(), SmoothDamp() methods
   Category: Animation, Preferred Parent: game

非推奨のチェック

User: Is BodyPosition deprecated?
AI: [uses roblox_check_deprecated("BodyPosition")]
→ Yes, deprecated. Use AlignPosition (constraint-based) instead.

FastFlagsの検索

User: What flags control physics?
AI: [uses roblox_search_fflags("physics")]
→ FIntPhysicsMaxSteps, DFFlagPhysicsDebug, FFlagPhysicsOptimized...

クラウドAPIエンドポイントの取得

User: How do I publish a message to a topic?
AI: [uses roblox_search_cloud_api("publish message")]
→ POST /v1/universes/{universeId}/topics/{topic}
   Auth: API Key with messaging-service:publish scope

Luauグローバル変数の取得

User: What built-in functions does Luau have?
AI: [uses roblox_get_luau_globals()]
→ print, warn, error, typeof, select, pairs, ipairs, next...

Luau言語ドキュメントの取得

User: How do type annotations work in Luau?
AI: [uses roblox_get_luau_topic("type-annotations")]
→ Complete guide on type syntax, generics, type inference...

DevForumの検索

User: How do people optimize memory in Roblox?
AI: [uses roblox_search_devforum("memory optimization")]
→ Links to relevant community discussions (cached for 1 hour)

データ型情報の取得

User: How do I create a Vector3?
AI: [uses roblox_get_datatype("Vector3")]
→ Vector3.new(x, y, z), Vector3.one, Vector3.zero
   Properties: X, Y, Z, Magnitude, Unit
   Methods: Cross, Dot, Lerp, Angle...

ライブラリ関数の取得

User: How does math.clamp work?
AI: [uses roblox_get_library_function("math", "clamp")]
→ math.clamp(x, min, max): number
   Returns x clamped between min and max

利用可能なツール（合計27）

コアAPIツール

拡張APIツール

FastFlagsツール

Luauグローバル変数ツール

Open Cloud APIツール

Luau言語ツール

データ型ツール

ライブラリツール

MCPリソース（v3.3.0+）

リソースは、URIベースで直接ドキュメントにアクセスできます。

MCPプロンプト（v3.3.0+）

プロンプトは、再利用可能なワークフローテンプレートを提供します。

データソース

すべてのデータは、無料の公開ソースから取得されます。

データ統計

サポートされる言語

roblox_sync(language="id-id")でドキュメントの言語を切り替えられます。

• en-us - 英語（デフォルト）
• id-id - インドネシア語
• ja-jp - 日本語
• ko-kr - 韓国語
• zh-cn - 中国語（簡体字）
• zh-tw - 中国語（繁体字）
• de-de - ドイツ語
• es-es - スペイン語
• fr-fr - フランス語
• it-it - イタリア語
• pt-br - ポルトガル語（ブラジル）
• ru-ru - ロシア語
• th-th - タイ語
• tr-tr - トルコ語
• vi-vn - ベトナム語

キャッシュの場所

データはシステムの標準キャッシュディレクトリにキャッシュされます。

• Windows: %LOCALAPPDATA%\mcp-roblox-docs\
• macOS: ~/Library/Caches/mcp-roblox-docs/
• Linux: ~/.cache/mcp-roblox-docs/

Robloxが新しいAPIバージョンをリリースすると、キャッシュは自動的に更新されます。

開発

# リポジトリをクローン
git clone https://github.com/nhattamgithub/mcp-roblox-docs
cd mcp-roblox-docs

# 依存関係をインストール
uv sync

# サーバーをローカルで実行
uv run mcp-roblox-docs

# ツールの数をテスト
uv run python -c "from src.server import mcp; print('Tools:', len(mcp._tool_manager._tools))"

# 配布用にビルド
uv build

# PyPIに公開
uv publish

変更履歴

v3.3.0 (2026-01-25)

完全なMCPプリミティブの実装

• MCPリソース（5つのリソーステンプレート）を追加:
  • roblox://class/{name} - クラスのドキュメントに直接アクセス
  • roblox://enum/{name} - 列挙型の値に直接アクセス
  • roblox://datatype/{name} - データ型のドキュメントに直接アクセス
  • roblox://library/{name} - ライブラリのドキュメントに直接アクセス
  • roblox://luau/{topic} - Luau言語のドキュメントに直接アクセス
• MCPプロンプト（4つのワークフローテンプレート）を追加:
  • explain-api - Roblox APIクラスを詳細に説明
  • debug-deprecation - 非推奨のAPIからの移行を支援
  • code-review - Roblox Luauコードをレビュー
  • learn-service - Robloxサービスについて学習
• 同期操作に2分のタイムアウトを追加
• すべての3つのMCPプリミティブ（ツール、リソース、プロンプト）を実装

v3.2.0 (2026-01-25)

MCPのベストプラクティスと品質の向上

• サーバーのステータス、統計情報、診断情報を取得するroblox_healthツールを追加
• ユーザー入力を受け付ける17のツールすべてに入力検証を追加
• MCP_ROBLOX_DOCS_LOG_LEVEL環境変数を使用した設定可能なロギングを追加
• PEP 561準拠のpy.typedマーカーファイルを追加
• DevForumのディスクキャッシュを改善し、保存時に期限切れのエントリをクリーンアップ
• ローダー内の重複した正規表現パターンを修正
• USER_AGENTを現在のバージョンに合わせて更新
• 合計27のツールになりました

v3.1.0 (2026-01-25)

開発者体験と検索機能の改善

• スペルミスを許容するファジー検索（例: "Tweenservce" → "TweenService"）
• サーバー再起動後も保持される永続的なDevForumキャッシュ
• roblox_searchツールにfuzzyパラメータを追加（デフォルト: True）
• フォーマッタのTypedDict型ヒントを修正し、型安全性を向上
• pytestテストスイートを追加（検証、検索、キャッシュに関する56のテスト）
• 開発用依存関係（pytest、pytest-asyncio）を追加

v3.0.1 (2026-01-25)

• 変更履歴の年を修正（2025 → 2026）

v3.0.0 (2026-01-25)

パフォーマンスと信頼性の向上

• セマフォを使用した並列ダウンロード（同期速度が7 - 10倍向上）
• 指数バックオフを伴うリトライロジック（3回試行）
• HTTP圧縮サポート（gzip、deflate）
• 事前コンパイルされた正規表現パターン（高速な解析）
• roblox_searchを通じてデータ型/ライブラリを検索可能に
• DevForumのレート制限（429エラーを防止）
• セキュリティのための入力検証モジュールを追加

v2.1.0 (2026-01-25)

• データ型のドキュメント（44の型: Vector3、CFrame、Color3、UDim2、TweenInfoなど）を追加
• Luauライブラリのドキュメント（11のライブラリ: math、string、table、taskなど）を追加
• 5つの新しいツールを追加: roblox_get_datatype、roblox_list_datatypes、roblox_get_library、roblox_get_library_function、roblox_list_libraries
• ツールの数を21から26に拡張

v2.0.0 (2026-01-25)

• FastFlagsのサポートを追加（FVariables.txtから14,000以上のフラグ）
• Luauグローバル変数を追加（87の組み込み関数/タイプ）
• Open Cloud REST APIを追加（openapi.jsonから865のエンドポイント）
• Luau言語のドキュメントを追加（20のトピック）
• クラスのメタデータ（カテゴリ、アイコン、推奨親）を追加
• DevForumのキャッシュを追加（TTL 1時間）
• 非推奨の代替案を強化（40以上のクラス、30以上のメンバーマッピング）
• ツールの数を11から21に拡張

v1.0.1

• 最初の安定版リリース
• コアAPIドキュメントツール
• DevForum検索の統合
• 多言語サポート

📄 ライセンス

MITライセンス - 詳細はLICENSEを参照してください。

クレジット

• Roblox-Client-Tracker by MaximumADHD
• Roblox Creator Docs by Roblox
• MCP Protocol by Anthropic