@pkwadsy/grok-mcp 1.0.1 → 1.1.1

package/README.md

@@ -2,21 +2,17 @@
 
 MCP server that wraps the xAI Grok API. Lets Claude and other AI agents delegate thinking, planning, and real-time search to Grok.
 
-## Setup
+## Quick Start
 
-```bash
-npm install -g @pkwadsy/grok-mcp
-```
-
-Or use directly with npx:
+One-liner to add to Claude Code on any device:
 
 ```bash
-npx @pkwadsy/grok-mcp
+claude mcp add grok -e XAI_API_KEY=your-key -- npx -y @pkwadsy/grok-mcp
 ```
 
 You need an xAI API key from [console.x.ai](https://console.x.ai).
 
-## Configure in Claude Code
+### Alternative: project config
 
 Add to your project's `.mcp.json`:
 
@@ -26,7 +22,7 @@ Add to your project's `.mcp.json`:
     "grok": {
       "type": "stdio",
       "command": "npx",
-      "args": ["@pkwadsy/grok-mcp"],
+      "args": ["-y", "@pkwadsy/grok-mcp"],
       "env": {
         "XAI_API_KEY": "your-xai-api-key"
       }
@@ -44,16 +40,17 @@ Single tool with options for different use cases.
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
 | `prompt` | string | yes | The question or task for Grok |
+| `files` | array | no | Files to include in context (path, optional start_line/end_line) |
 | `system_prompt` | string | no | Custom system prompt |
-| `model` | string | no | Model to use (default: `grok-4.20-reasoning`) |
-| `web_search` | boolean | no | Enable real-time web search |
+| `model` | string | no | Model to use (default: `grok-4.20-multi-agent`) |
+| `web_search` | boolean | no | Web search, enabled by default |
 | `x_search` | boolean | no | Enable X/Twitter search |
 
 ### Available Models
 
-- `grok-4.20-reasoning` — flagship reasoning (default)
+- `grok-4.20-multi-agent` — multi-agent mode, great for architecture and planning (default)
+- `grok-4.20-reasoning` — flagship reasoning
 - `grok-4.20-non-reasoning` — fast, no reasoning
-- `grok-4.20-multi-agent` — multi-agent mode, great for architecture and planning
 - `grok-4.1-fast-reasoning` — cheaper reasoning
 - `grok-4.1-fast-non-reasoning` — cheapest, fast
 

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { readFile } from "node:fs/promises";
 import { z } from "zod";
 const apiKey = process.env.XAI_API_KEY;
 if (!apiKey) {
@@ -44,8 +45,16 @@ async function callGrok(options) {
     }
     throw new Error("No text content in Grok response");
 }
-server.tool("ask_grok", "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.", {
-    prompt: z.string().describe("The question or task for Grok. Include all relevant context — code snippets, error messages, constraints, and background — since Grok has no access to your conversation or files"),
+server.tool("ask_grok", `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: ${process.cwd()}`, {
+    prompt: z.string().describe("The question or task for Grok. Include all relevant context — constraints, background, and goals — since Grok has no access to your conversation or files. Use the files parameter to attach source code rather than pasting it inline"),
+    files: z
+        .array(z.object({
+        path: z.string().describe("Absolute path to the file"),
+        start_line: z.number().optional().describe("First line to include (1-based, inclusive)"),
+        end_line: z.number().optional().describe("Last line to include (1-based, inclusive)"),
+    }))
+        .optional()
+        .describe("Files to read and include in the context sent to Grok. Each file is included with its path and line numbers. Use start_line/end_line to include only a specific range"),
     system_prompt: z
         .string()
         .optional()
@@ -63,12 +72,57 @@ server.tool("ask_grok", "Ask Grok a question. Grok is great for thinking, planni
         .boolean()
         .optional()
         .describe("Enable X/Twitter search to find and analyze posts"),
-}, async ({ prompt, system_prompt, model, web_search, x_search }) => {
+}, async ({ prompt, files, system_prompt, model, web_search, x_search }) => {
     const messages = [];
     if (system_prompt) {
         messages.push({ role: "system", content: system_prompt });
     }
-    messages.push({ role: "user", content: prompt });
+    let userContent = prompt;
+    if (files && files.length > 0) {
+        const cwd = process.cwd();
+        const fileBlocks = [`Working directory: ${cwd}\n`];
+        const errors = [];
+        for (const file of files) {
+            try {
+                const raw = await readFile(file.path, "utf-8");
+                const allLines = raw.split("\n");
+                const totalLines = allLines.length;
+                if (file.start_line && file.start_line > totalLines) {
+                    errors.push(`${file.path}: start_line ${file.start_line} is past end of file (${totalLines} lines)`);
+                    continue;
+                }
+                if (file.end_line && file.end_line > totalLines) {
+                    errors.push(`${file.path}: end_line ${file.end_line} is past end of file (${totalLines} lines)`);
+                    continue;
+                }
+                if (file.start_line && file.end_line && file.start_line > file.end_line) {
+                    errors.push(`${file.path}: start_line ${file.start_line} is after end_line ${file.end_line}`);
+                    continue;
+                }
+                const start = file.start_line ? file.start_line - 1 : 0;
+                const end = file.end_line ? file.end_line : totalLines;
+                const sliced = allLines.slice(start, end);
+                const numbered = sliced
+                    .map((line, i) => `${start + i + 1}\t${line}`)
+                    .join("\n");
+                const range = file.start_line || file.end_line
+                    ? `:${file.start_line ?? 1}-${file.end_line ?? allLines.length}`
+                    : "";
+                fileBlocks.push(`--- ${file.path}${range} ---\n${numbered}\n---`);
+            }
+            catch (err) {
+                errors.push(`${file.path}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        if (errors.length > 0) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Failed to read ${errors.length} file(s):\n${errors.join("\n")}\n\nFix the paths and try again.` }],
+            };
+        }
+        userContent = `${fileBlocks.join("\n\n")}\n\n${prompt}`;
+    }
+    messages.push({ role: "user", content: userContent });
     const tools = [];
     if (web_search !== false) {
         tools.push({ type: "web_search" });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pkwadsy/grok-mcp",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "description": "MCP server that wraps the xAI Grok API — delegate thinking, planning, and search to Grok",
   "type": "module",
   "main": "dist/index.js",