@lkbaba/grok-mcp 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,40 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-03-12
+
+### Added
+
+- **grok_agent_search** - Smart search tool with Web + X (Twitter) search
+  - `search_type`: web / x / mixed (default: mixed)
+  - `model`: grok-4.20-beta (default) / grok-4-latest
+  - `output_format`: text (Markdown) / json (structured)
+  - `web_search_config`: domain filters, image understanding
+  - `x_search_config`: date range, handle filters, video understanding
+  - Transparent citation URLs (not redirects)
+
+- **grok_brainstorm** - Creative brainstorming tool
+  - `count`: generate 1-10 ideas (default: 5)
+  - `style`: innovative / practical / radical / balanced
+  - `context_files`: read project files as context
+  - `output_format`: text / json (with title/description/pros/cons/feasibility)
+  - Temperature auto-adjustment based on style
+
+- **Core Infrastructure**
+  - Native fetch (undici) for xAI API calls, auto proxy support
+  - Zod-based parameter validation
+  - Retry logic with exponential backoff (3 attempts)
+  - Performance monitoring and logging (all to stderr)
+  - TypeScript ESM with strict mode
+
+### Technical Details
+
+- Runtime: Node.js 20+
+- MCP SDK: @modelcontextprotocol/sdk ^1.0.0
+- Default model: grok-4.20-beta ($0.20/$0.50 per M tokens, 2M context)
+- API endpoint: xAI Responses API (`/v1/responses`)
+- No OpenAI SDK dependency (native fetch for better xAI compatibility)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LKbaba
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,179 @@
+# Grok MCP Server
+
+> **Give Claude Code the power of Grok 4.20**
+
+An MCP server that connects Claude Code to xAI's Grok, unlocking real-time web search and X (Twitter) search capabilities.
+
+## Why Grok + Claude?
+
+| Grok's Strengths | Use Case |
+|-------------------|----------|
+| **Web + X Search** | Real-time information with transparent source URLs |
+| **X/Twitter Search** | Track social media trends, public opinion, breaking news |
+| **4-Agent Architecture** | Harper (research) + Benjamin (logic) + Lucas (creative) collaboration |
+| **2M Token Context** | Massive context window with grok-4.20-beta |
+
+> **Philosophy**: Claude is the commander, Grok is the specialist for real-time search and social media intelligence.
+
+## Quick Start
+
+### 1. Get API Key
+
+Visit [xAI Console](https://console.x.ai/) and create an API key.
+
+### 2. Configure Claude Code
+
+Add to your MCP config file:
+
+- **Mac**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+- **Linux**: `~/.config/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "grok-mcp": {
+      "command": "npx",
+      "args": ["-y", "@lkbaba/grok-mcp"],
+      "env": {
+        "XAI_API_KEY": "your_xai_api_key_here"
+      }
+    }
+  }
+}
+```
+
+### 3. Restart Claude Code
+
+## Tools (2)
+
+### grok_agent_search - Smart Search
+
+Real-time web and X (Twitter) search powered by Grok.
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `query` | string | Yes | - | Search query |
+| `search_type` | enum | No | `mixed` | `web` / `x` / `mixed` (recommended) |
+| `model` | enum | No | `grok-4.20-beta` | `grok-4.20-beta` (fast) / `grok-4-latest` (best quality) |
+| `output_format` | enum | No | `text` | `text` (Markdown) / `json` (structured) |
+| `web_search_config` | object | No | - | Domain filters, image understanding |
+| `x_search_config` | object | No | - | Date range, handle filters, video understanding |
+
+**Example:**
+```
+"Search for the latest Claude Code updates on X and the web"
+```
+
+### grok_brainstorm - Creative Brainstorming
+
+Multi-perspective idea generation with project context support.
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `topic` | string | Yes | - | Brainstorming topic |
+| `context` | string | No | - | Additional context |
+| `context_files` | string[] | No | - | Project files to read as context |
+| `count` | number | No | `5` | Number of ideas (1-10) |
+| `style` | enum | No | `balanced` | `innovative` / `practical` / `radical` / `balanced` |
+| `model` | enum | No | `grok-4.20-beta` | Model selection |
+| `output_format` | enum | No | `text` | `text` (Markdown) / `json` (structured with pros/cons/feasibility) |
+
+**Example:**
+```
+"Brainstorm 3 practical ideas for improving user onboarding, read ./README.md for context"
+```
+
+## Model Selection
+
+| Model | Price (input/output) | Context | Speed | Best For |
+|-------|---------------------|---------|-------|----------|
+| `grok-4.20-beta` | $0.20 / $0.50 per M | 2M | Fast | Default, 4-Agent native, lowest hallucination |
+| `grok-4-latest` | $2.50 / $10.00 per M | 256K | Slow | Complex tasks requiring highest quality |
+
+## Performance
+
+Tested on 2026-03-12:
+
+| Operation | Model | Time | Tokens |
+|-----------|-------|------|--------|
+| Web Search | grok-4.20-beta | ~29s | ~70K |
+| X Search | grok-4.20-beta | ~28s | ~48K |
+| Brainstorm (3 ideas) | grok-4.20-beta | ~16s | ~3.6K |
+
+## Proxy Configuration
+
+<details>
+<summary>For users behind proxy/VPN</summary>
+
+Add proxy environment variable to your config:
+
+```json
+{
+  "mcpServers": {
+    "grok-mcp": {
+      "command": "npx",
+      "args": ["-y", "@lkbaba/grok-mcp"],
+      "env": {
+        "XAI_API_KEY": "your_xai_api_key_here",
+        "HTTPS_PROXY": "http://127.0.0.1:7897"
+      }
+    }
+  }
+}
+```
+
+Native `fetch` (undici) automatically reads proxy environment variables.
+</details>
+
+## Local Development
+
+<details>
+<summary>Build from source</summary>
+
+```bash
+git clone https://github.com/LKbaba/Grok-mcp.git
+cd Grok-mcp
+npm install
+npm run build
+export XAI_API_KEY="your_xai_api_key_here"
+npm start
+```
+</details>
+
+## Project Structure
+
+```
+src/
+├── config/
+│   └── index.ts          # Configuration (zod validation)
+├── types/
+│   └── index.ts          # TypeScript type definitions
+├── tools/
+│   ├── definitions.ts    # MCP tool JSON Schema definitions
+│   ├── agent-search.ts   # grok_agent_search implementation
+│   └── brainstorm.ts     # grok_brainstorm implementation
+├── utils/
+│   ├── grok-client.ts    # xAI API client (native fetch)
+│   ├── tool-builder.ts   # Search tool parameter builder
+│   └── logger.ts         # Logging and performance monitoring
+└── index.ts              # MCP server entry point
+```
+
+## Comparison with Gemini MCP
+
+| Feature | Gemini MCP | Grok MCP |
+|---------|-----------|----------|
+| Web Search | Google Search (grounding) | Grok Web Search |
+| X/Twitter Search | Not available | **Native support** |
+| Citation URLs | Google redirect (opaque) | **Direct URLs (transparent)** |
+| Search Speed | ~8-10s (flash) | ~16-29s (grok-4.20) |
+| Codebase Analysis | 1M token context | Not available |
+| Multimodal | Image analysis | Not available |
+| Brainstorm | Structured JSON | **Structured JSON + style/count/context_files** |
+
+**Best strategy**: Use both! Gemini for speed and code analysis, Grok for deep search and X/Twitter intelligence.
+
+## License
+
+MIT

package/dist/config/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Grok-MCP Configuration Module
+ *
+ * Loads environment variables, validates config, and exports type-safe configuration objects
+ */
+import type { GrokMCPConfig } from '../types/index.js';
+/**
+ * Supported model list
+ * grok-4.20-beta: Default model, fast, affordable, 2M context, 4-Agent native architecture
+ * grok-4-latest: Flagship model, highest quality, suitable for complex tasks
+ */
+export declare const SUPPORTED_MODELS: readonly ["grok-4.20-beta", "grok-4-latest"];
+export type SupportedModel = typeof SUPPORTED_MODELS[number];
+/**
+ * xAI API configuration
+ */
+export declare const xaiConfig: {
+    /** API key */
+    readonly apiKey: string;
+    /** API base URL */
+    readonly baseURL: "https://api.x.ai/v1";
+    /** Default model (v3: switched from grok-4-latest to grok-4.20-beta) */
+    readonly defaultModel: SupportedModel;
+    /** Request timeout (milliseconds) */
+    readonly timeout: 120000;
+};
+/**
+ * MCP service configuration
+ */
+export declare const mcpConfig: {
+    /** Service name */
+    readonly name: "grok-mcp";
+    /** Service version */
+    readonly version: "1.0.0";
+};
+/**
+ * Debug mode
+ */
+export declare const debugMode: boolean;
+/**
+ * Full configuration object
+ */
+export declare const config: GrokMCPConfig;
+/**
+ * Print configuration info (for debugging)
+ */
+export declare function printConfig(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAuDvD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,8CAA+C,CAAC;AAC7E,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB,cAAc;;IAEd,mBAAmB;;IAEnB,wEAAwE;2BACtC,cAAc;IAChD,qCAAqC;;CAE7B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB,mBAAmB;;IAEnB,sBAAsB;;CAEd,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,SAAS,SAAuB,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,aAKpB,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,SAO1B"}

package/dist/config/index.js

@@ -0,0 +1,101 @@
+/**
+ * Grok-MCP Configuration Module
+ *
+ * Loads environment variables, validates config, and exports type-safe configuration objects
+ */
+import { config as dotenvConfig } from 'dotenv';
+import { z } from 'zod';
+// Load .env file
+dotenvConfig();
+// ============================================================================
+// Config Validation Schema
+// ============================================================================
+/**
+ * Environment variable validation schema
+ */
+const envSchema = z.object({
+    // xAI API configuration
+    XAI_API_KEY: z.string().min(1, 'XAI_API_KEY environment variable is required'),
+    // Debug mode (optional)
+    DEBUG: z.string().optional(),
+});
+// ============================================================================
+// Config Validation & Loading
+// ============================================================================
+/**
+ * Validate environment variables
+ */
+function validateEnv() {
+    try {
+        return envSchema.parse(process.env);
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            const messages = error.errors.map((err) => `  - ${err.path.join('.')}: ${err.message}`);
+            throw new Error(`Configuration validation failed:\n${messages.join('\n')}\n\n` +
+                'Please check your .env file or set the required environment variables.\n' +
+                'Refer to .env.example for required configuration items.');
+        }
+        throw error;
+    }
+}
+/**
+ * Validated environment variables
+ */
+const env = validateEnv();
+// ============================================================================
+// Export Configuration Objects
+// ============================================================================
+/**
+ * Supported model list
+ * grok-4.20-beta: Default model, fast, affordable, 2M context, 4-Agent native architecture
+ * grok-4-latest: Flagship model, highest quality, suitable for complex tasks
+ */
+export const SUPPORTED_MODELS = ['grok-4.20-beta', 'grok-4-latest'];
+/**
+ * xAI API configuration
+ */
+export const xaiConfig = {
+    /** API key */
+    apiKey: env.XAI_API_KEY,
+    /** API base URL */
+    baseURL: 'https://api.x.ai/v1',
+    /** Default model (v3: switched from grok-4-latest to grok-4.20-beta) */
+    defaultModel: 'grok-4.20-beta',
+    /** Request timeout (milliseconds) */
+    timeout: 120000, // 120 seconds
+};
+/**
+ * MCP service configuration
+ */
+export const mcpConfig = {
+    /** Service name */
+    name: 'grok-mcp',
+    /** Service version */
+    version: '1.0.0',
+};
+/**
+ * Debug mode
+ */
+export const debugMode = env.DEBUG === 'true';
+/**
+ * Full configuration object
+ */
+export const config = {
+    apiKey: xaiConfig.apiKey,
+    baseURL: xaiConfig.baseURL,
+    model: xaiConfig.defaultModel,
+    debug: debugMode,
+};
+/**
+ * Print configuration info (for debugging)
+ */
+export function printConfig() {
+    console.error('Grok-MCP Configuration:');
+    console.error('  - API URL:', xaiConfig.baseURL);
+    console.error('  - Default Model:', xaiConfig.defaultModel);
+    console.error('  - Timeout:', xaiConfig.timeout, 'ms');
+    console.error('  - Debug Mode:', debugMode ? 'enabled' : 'disabled');
+    console.error('  - MCP Service:', `${mcpConfig.name} v${mcpConfig.version}`);
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Grok-MCP Entry Point
+ * MCP protocol-based Grok API service
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,182 @@
+#!/usr/bin/env node
+/**
+ * Grok-MCP Entry Point
+ * MCP protocol-based Grok API service
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { mcpConfig } from './config/index.js';
+import { TOOL_DEFINITIONS } from './tools/definitions.js';
+import { grokAgentSearch } from './tools/agent-search.js';
+import { grokBrainstorm } from './tools/brainstorm.js';
+import { logger, startPerformanceMonitor } from './utils/logger.js';
+// ============================================================================
+// MCP Server Initialization
+// ============================================================================
+/**
+ * Create MCP server instance
+ */
+const server = new Server({
+    name: mcpConfig.name,
+    version: mcpConfig.version,
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// ============================================================================
+// Request Handlers
+// ============================================================================
+/**
+ * Handle tools/list request
+ */
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    logger.debug('Received tools/list request');
+    return { tools: TOOL_DEFINITIONS };
+});
+/**
+ * Handle tools/call request
+ */
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    logger.info(`Received tool call: ${name}`);
+    logger.debug('Tool arguments', args);
+    // Start performance monitoring
+    const monitor = startPerformanceMonitor(`Tool call: ${name}`);
+    try {
+        switch (name) {
+            case 'grok_agent_search': {
+                // Call grok_agent_search tool
+                const input = args;
+                const result = await grokAgentSearch(input);
+                // Record performance and usage stats
+                const duration = monitor.end({
+                    tokens: result.usage.total_tokens,
+                    citations: result.citations.length,
+                });
+                // Format output
+                let output = `# Search Results\n\n${result.content}\n\n`;
+                if (result.citations.length > 0) {
+                    output += `## Citations\n\n`;
+                    result.citations.forEach((url, index) => {
+                        output += `${index + 1}. ${url}\n`;
+                    });
+                    output += `\n`;
+                }
+                output += `## Usage Statistics\n\n`;
+                output += `- Model: ${input.model || 'grok-4.20-beta'}\n`;
+                output += `- Input Tokens: ${result.usage.input_tokens}\n`;
+                output += `- Output Tokens: ${result.usage.output_tokens}\n`;
+                output += `- Reasoning Tokens: ${result.usage.reasoning_tokens}\n`;
+                output += `- Total Tokens: ${result.usage.total_tokens}\n`;
+                output += `- Web Search Calls: ${result.usage.web_search_calls}\n`;
+                output += `- X Search Calls: ${result.usage.x_search_calls}\n`;
+                output += `- Duration: ${duration}ms\n`;
+                logger.info(`Search completed in ${duration}ms`);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: output,
+                        },
+                    ],
+                };
+            }
+            case 'grok_brainstorm': {
+                // Call grok_brainstorm tool
+                const input = args;
+                const result = await grokBrainstorm(input);
+                // Record performance and usage stats
+                const duration = monitor.end({
+                    tokens: result.usage.total_tokens,
+                });
+                // Format output
+                let output = `# Brainstorm Results\n\n`;
+                output += `**Topic**: ${input.topic}\n`;
+                output += `**Style**: ${input.style || 'balanced'} | **Count**: ${input.count || 5}\n\n`;
+                if (input.context) {
+                    output += `**Context**: ${input.context}\n\n`;
+                }
+                if (input.context_files && input.context_files.length > 0) {
+                    output += `**Reference Files**: ${input.context_files.join(', ')}\n\n`;
+                }
+                output += `---\n\n${result.content}\n\n`;
+                output += `---\n\n## Usage Statistics\n\n`;
+                output += `- Model: ${input.model || 'grok-4.20-beta'}\n`;
+                output += `- Input Tokens: ${result.usage.input_tokens}\n`;
+                output += `- Output Tokens: ${result.usage.output_tokens}\n`;
+                output += `- Reasoning Tokens: ${result.usage.reasoning_tokens}\n`;
+                output += `- Total Tokens: ${result.usage.total_tokens}\n`;
+                output += `- Duration: ${duration}ms\n`;
+                logger.info(`Brainstorm completed in ${duration}ms`);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: output,
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        logger.error(`Tool call failed: ${name}`, error);
+        throw error;
+    }
+});
+// ============================================================================
+// Server Startup
+// ============================================================================
+/**
+ * Start MCP server
+ */
+async function main() {
+    try {
+        logger.info('Starting Grok-MCP server...');
+        logger.info(`Service name: ${mcpConfig.name}`);
+        logger.info(`Service version: ${mcpConfig.version}`);
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        logger.info('Grok-MCP server started');
+        logger.info('Waiting for client connection...');
+    }
+    catch (error) {
+        logger.error('Server startup failed', error);
+        process.exit(1);
+    }
+}
+// ============================================================================
+// Error Handling
+// ============================================================================
+/**
+ * Handle uncaught exceptions
+ */
+process.on('uncaughtException', (error) => {
+    logger.error('Uncaught exception', error);
+    process.exit(1);
+});
+/**
+ * Handle unhandled promise rejections
+ * Only log the error, do not exit — a single request failure should not terminate the MCP server
+ */
+process.on('unhandledRejection', (reason, promise) => {
+    logger.error('Unhandled promise rejection', reason);
+});
+/**
+ * Handle process termination signals
+ */
+process.on('SIGINT', () => {
+    logger.info('Received SIGINT, shutting down server...');
+    process.exit(0);
+});
+process.on('SIGTERM', () => {
+    logger.info('Received SIGTERM, shutting down server...');
+    process.exit(0);
+});
+// Start server
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/agent-search.d.ts

@@ -0,0 +1,14 @@
+/**
+ * grok_agent_search Tool Implementation
+ *
+ * Intelligent search using Grok AI, supports Web search, X search, or mixed search
+ */
+import type { GrokAgentSearchInput, GrokAgentSearchOutput } from '../types/index.js';
+/**
+ * grok_agent_search main function
+ *
+ * @param input - Search input parameters
+ * @returns Search result
+ */
+export declare function grokAgentSearch(input: GrokAgentSearchInput): Promise<GrokAgentSearchOutput>;
+//# sourceMappingURL=agent-search.d.ts.map

package/dist/tools/agent-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-search.d.ts","sourceRoot":"","sources":["../../src/tools/agent-search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAyB3B;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAmIhC"}