Ask262

Ask262

engine262 における ECMAScript 仕様とその実装を調べるための MCP サーバーです。

🎮 今すぐ試す

JavaScript の内部を手軽に調べる方法です。

• Ask262 Chat — 自然言語で質問できます（新しいアカウントの登録が必要です）
• MCP Inspector — すべての MCP ツールに直接アクセスできます。サインアップは不要です
• npx add-mcp "https://ask262.bendtherules.in/mcp"

機能

• ベクトル検索：意味的なクエリを使って ECMAScript 仕様のセクションを検索します
• JavaScript の実行：engine262 で JavaScript を実行して仕様のセクションを取得します。コードの重要な部分をマークするには、ask262Debug.startImportant() を使用します
• ナレッジグラフ：仕様のセクションと実装関数を対応付けます
• 1 秒のタイムアウト：安全のため、コードの実行を 1 秒でタイムアウトします

利用可能なツール

ツール	説明
ask262_search_spec_sections	関連するセクションを ECMAScript 仕様からベクトル検索します
ask262_get_section_content	仕様のセクションの全文を取得します
ask262_evaluate_in_engine262	JS を実行して仕様のセクションを取得します。「important」マークを使うと、関連する部分に絞り込めます

クイックスタート（ホスト済みインスタンス）

ローカル環境のセットアップなしで、ホスト済みの MCP サーバーを使用できます。

推奨方法：npx add-mcp

1 つのコマンドで、ask262 MCP サーバーをクライアントにインストールできます。

npx add-mcp "https://ask262.bendtherules.in/mcp"

手動設定

手動で設定する場合は、次の手順に従ってください。

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "ask262": {
      "url": "https://ask262.bendtherules.in/mcp"
    }
  }
}

OpenCode（~/.config/opencode/opencode.json）：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ask262": {
      "type": "remote",
      "url": "https://ask262.bendtherules.in/mcp",
      "enabled": true
    }
  }
}

ローカルインストール

前提条件

• Bun：バージョン 1.0.0 以降（インストール）
• Ollama：qwen3-embedding:8b をインストールしてください
  （ollama pull qwen3-embedding:8b）

セットアップ

# Clone and install
git clone https://github.com/bendtherules/ask262
cd ask262
bun install

# Or install globally
bun install -g ask262

環境設定

.env.example をコピーして設定します。

cp .env.example .env

主要な変数：

• ASK262_EMBEDDING_PROVIDER：ollama（ローカル）または fireworks（クラウド）を選択します。デフォルト：ollama
• OLLAMA_HOST：Ollama サーバーの URL。デフォルト：http://localhost:11434
• FIREWORKS_API_KEY：Fireworks を使用する場合に必要です。https://app.fireworks.ai から取得してください
• ASK262_PORT：HTTP サーバーのポート。デフォルト：8081

.env の例：

# Use Fireworks for embeddings (faster, cloud-based)
ASK262_EMBEDDING_PROVIDER=fireworks
FIREWORKS_API_KEY=fw_your_key_here

# Or use local Ollama (default)
# ASK262_EMBEDDING_PROVIDER=ollama
# OLLAMA_HOST=http://localhost:11434

ローカル MCP 設定

Claude Desktop（claude_desktop_config.json）：

stdio（サーバー不要）

{
  "mcpServers": {
    "ask262": {
      "command": "bunx",
      "args": ["ask262"]
    }
  }
}

http（サーバーが必要）

{
  "mcpServers": {
    "ask262": {
      "url": "http://localhost:8081/mcp"
    }
  }
}

⬇️ 上記の HTTP 設定に必要です：

bun run ask262-http # start HTTP server

OpenCode（~/.config/opencode/opencode.json）：

stdio（サーバー不要）

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ask262": {
      "type": "local",
      "command": ["bunx", "ask262"],
      "enabled": true
    }
  }
}

http（サーバーが必要）

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ask262": {
      "type": "remote",
      "url": "http://localhost:8081/mcp",
      "enabled": true
    }
  }
}

⬇️ 上記の HTTP 設定に必要です：

bun run ask262-http # start HTTP server

HTTP サーバーのエンドポイント：

エンドポイント	説明
GET /health	ヘルスチェック
GET/POST /mcp	MCP プロトコルのエンドポイント
GET /	MCP Inspector の UI（/mcp に自動接続します）

注：適切にリクエストを処理できるよう、/mcp は Inspector のキャッチオールルート / より前に定義されています。

テスト

# Run MCP server tests
bun run test-mcp-server

# Test evaluate tool with timeout
bun run test-evaluate-timeout

# Test search functionality
bun run test-search-spec-sections

開発

開発する場合や、カスタムの ECMAScript 仕様を使用する場合：

1. クローンとセットアップ：

   git clone https://github.com/bendtherules/ask262
   cd ask262
   bun install
   

2. 仕様が存在することを確認：

   • ./spec-built/multipage/ - ビルド済みの ECMAScript 仕様 HTML ファイル

   手順 -

   1. git clone https://github.com/tc39/ecma262
   2. npm i && npm run build
   3. ecma262 の out/ をこのリポジトリの spec-built/ にコピーします

3. ベクトルをビルド（lancedb）

   bun run ingest
   

4. npm にリリース（メンテナーのみ）：

   bun run release
   

   これにより、次の処理が行われます。

   • 未コミットの git 変更を確認します
   • パッチバージョンを上げます（例：0.0.1 → 0.0.2）
   • storage/ 内のハードリンクを修正します
   • チェックを実行してリリースします

   その他のオプション：bun run release -- --minor、bun run release -- --major、または bun run release -- --no-bump

ライセンス

ISC