grok-mcp
grok-mcp
xAI Grok APIをラップするMCPサーバー。Claudeやその他のAIエージェントが、思考、計画、リアルタイム検索をGrokに委任できるようにします。
クイックスタート
あらゆるデバイスでClaude Codeに追加するためのワンライナー:
claude mcp add grok -e XAI_API_KEY=your-key -- npx -y @pkwadsy/grok-mcpconsole.x.aiからxAI APIキーを取得する必要があります。
代替案:プロジェクト設定
プロジェクトの .mcp.json に以下を追加します:
{
"mcpServers": {
"grok": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@pkwadsy/grok-mcp"],
"env": {
"XAI_API_KEY": "your-xai-api-key"
}
}
}
}Related MCP server: grok-search-mcp
ツール
ask_grok
ファイルコンテキスト、ウェブ検索、X/Twitter検索をオプションとして指定し、Grokに質問します。
パラメータ | 型 | 必須 | 説明 |
| string | はい | Grokへの質問またはタスク |
| string[] | いいえ | コンテキストに含めるファイル(以下のファイル構文を参照) |
| number | いいえ | 最大ファイル数の上書き(デフォルト50) |
| number | いいえ | ファイルごとの最大サイズ(KB)の上書き(デフォルト32) |
| string | いいえ | カスタムシステムプロンプト |
| string | いいえ | 使用するモデル(デフォルト: |
| boolean | いいえ | ウェブ検索(デフォルトで有効) |
| boolean | いいえ | X/Twitter検索を有効にする |
check_files
ファイルのドライラン解決。Grokを呼び出さずに、すべてのファイルを検証しサイズを表示します。check_files が成功すれば、ask_grok も成功します。
パラメータ | 型 | 必須 | 説明 |
| string[] | はい | チェックするファイル( |
| number | いいえ | 最大ファイル数の上書き(デフォルト50) |
| number | いいえ | ファイルごとの最大サイズ(KB)の上書き(デフォルト32) |
ファイル構文
ファイルはコンパクトな構文の文字列配列として渡されます:
構文 | 説明 |
| ファイル全体 |
| 10行目から30行目 |
| 10行目のみ |
| グロブパターン |
| ファイルごとのサイズ制限をバイパス |
| 行範囲と強制指定の組み合わせ |
安全制限
制限 | デフォルト | 上書き |
呼び出しごとのファイル数 | 50 |
|
ファイルごとのサイズ | 32 KB |
|
合計コンテキスト | 256 KB | ハードキャップ(上書き不可) |
利用可能なモデル
grok-4.20-multi-agent— マルチエージェントモード、アーキテクチャや計画に最適(デフォルト)grok-4.20-reasoning— フラッグシップ推論モデルgrok-4.20-non-reasoning— 高速、推論なしgrok-4.1-fast-reasoning— より安価な推論モデルgrok-4.1-fast-non-reasoning— 最も安価で高速
例
ファイルコンテキストを指定して質問:
prompt: "Review this code for bugs"
files: ["src/index.ts", "src/utils.ts:20-50"]ウェブ検索:
prompt: "What happened in tech news today?"X/Twitter検索:
prompt: "What are people saying about the new React release?"
x_search: true質問前にファイルをチェック:
files: ["src/**/*.ts"]ライセンス
MIT
Available Tools
2 toolsask_grokA
Ask Grok a question. Grok is great for thinking, planning, architecture, and real-time search via web and X/Twitter. Use web_search for current information from the internet. Use x_search to find and analyze posts on X/Twitter. IMPORTANT: Grok has no context about your conversation or codebase. Always include all relevant context directly in the prompt — file contents, error messages, architecture details, constraints, and goals. The more context you provide, the better Grok's response will be. Do not assume Grok knows anything about the current project. Use the files parameter to automatically include file contents with line numbers — this is preferred over pasting code into the prompt. File paths are resolved relative to the server working directory: /app. Responses include a response_id — pass it back as previous_response_id to continue a conversation without resending context.
Inputs: prompt (required), previous_response_id, files, max_files, +5 more.
check_filesA
Dry-run file resolution. Use this before ask_grok to verify files will resolve correctly and check context size. Uses the same validation as ask_grok — if check_files passes, ask_grok will too. File paths resolve relative to: /app
Inputs: files (required), max_files, max_file_size.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
ask_grok and check_files serve clearly distinct purposes: one is for querying Grok, the other is a dry-run validator for file resolution. No overlap or ambiguity.
Both tool names follow a consistent verb_noun pattern (ask_grok, check_files), using underscores and clear verbs.
Only 2 tools feels thin for a server that provides access to Grok, which could benefit from additional tools for conversation management or specialized searches.
The tool set lacks basic conversational features like retrieving history or managing context, and the promised web_search/x_search capabilities are not exposed as separate tools, limiting functionality.
Maintenance
Related MCP Connectors
Hosted X (Twitter) MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Hosted MCP server from TwitterAPI.io that gives AI agents read-only access to Twitter/X data. 12 tools: tweet search with X operators, user profiles, a user's latest tweets, followers and followings, replies, quotes, retweeters, mentions and trends. Connect at https://mcp.twitterapi.io/mcp with a TwitterAPI.io API key or account sign-in; usage is paid per result returned.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Related MCP Servers
- AlicenseAqualityBmaintenanceUse XAI's latest api functionalities with Grok MCP. It supports image understanding and generation, live search, latest models and more.2255MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that enables coding agents to search X/Twitter and the web through the local Grok CLI, providing better search results than default Codex or Claude search without requiring an API key.7MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for xAI Grok API with 19 tools for chat, web and X search, session management, tool chaining, image and video generation, and documentation.2MIT
- AlicenseNot gradedqualityDmaintenanceA single-file MCP server that enhances Claude Desktop with real-time web and X search, multi-tool agent, and image/video generation via xAI's Grok.MIT