Grok API 交互工具

┌─────────────────────────────────────────────────────────┐
│  CLI Client (Rust) - grok-ask                           │
│  - Standalone binary, no dependencies                   │
│  - Direct Grok API calls via HTTP                       │
│  - Use as Claude Code skill or command line             │
└─────────────────────┬───────────────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────────────┐
│  Grok API                                               │
│  - Models: grok-4-1-fast-non-reasoning / grok-4-1-fast  │
│  - Automatic grounding (web_search, x_search)           │
│  - Server-side conversation state                       │
└─────────────────────┬───────────────────────────────────┘
                      ▲
                      │
┌─────────────────────┴───────────────────────────────────┐
│  MCP Server (Python/FastMCP) - optional                 │
│  - For Claude Desktop, Cursor, etc.                     │
│  - Same API features via MCP tools                      │
└─────────────────────────────────────────────────────────┘

# Install the binary first
cd cli
cargo install --path .

# Make sure Cargo binaries are on your PATH
export PATH="$HOME/.cargo/bin:$PATH"

# Set API key
export XAI_API_KEY=your_key_here

# Quick web search
grok-ask --search "latest AI news"

# Get grounded answer
grok-ask --ask "What is xAI?"

# Deep reasoning
grok-ask --think "Compare Grok to GPT-4"

# Chat without web search
grok-ask --chat "Tell me a joke"

# Search X (Twitter) posts
grok-ask --x-search "AI news"

# Get answers grounded in X posts
grok-ask --x-ask "What are people saying about Grok?"

# X search with filters
grok-ask --x-search "AI safety" --allowed-handles elonmusk,sama
grok-ask --x-search "SpaceX" --from-date 2025-01-01 --to-date 2025-01-15
grok-ask --x-ask "Latest xAI updates" --enable-images --enable-video

# Follow-up conversation
grok-ask --ask "What products does xAI offer?" -r <response_id>

# JSON output
grok-ask --ask "Query" -o json

cd server
uv sync
cp .env.example .env
# Edit .env with your XAI_API_KEY
uv run python server.py

# Install globally
cd cli
cargo install --path .

# If grok-ask is not found afterwards, add Cargo's bin directory to your shell PATH
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.zshrc
# Reload your shell if you want the new PATH to apply immediately in the current terminal.
# This is only needed after editing ~/.zshrc; opening a new terminal works too.
source ~/.zshrc

# Or build locally
cargo build --release
# Binary at: ./target/release/grok-ask

cd server
uv sync
cp .env.example .env
# Edit .env with your XAI_API_KEY

search("latest AI news 2025")

ask("What is xAI and what products do they offer?")

think("Compare Grok's capabilities to other AI models")

chat("Tell me a joke about programming")

x_search("AI safety discussions")

# Only from specific handles
x_search("AI news", allowed_handles=["elonmusk", "sama"])

# Date range
x_search("SpaceX launch", from_date="2025-01-01", to_date="2025-01-15")

# With media understanding
x_search("xAI demos", enable_images=True, enable_video=True)

x_ask("What are people saying about Grok?")

# From specific accounts
x_ask("Latest xAI announcements", allowed_handles=["xai"])

# First question
response = ask("What is quantum computing?")
# Returns: ... response_id: resp_abc123

# Follow-up (Grok remembers context)
response = ask("How is it different from classical computing?", response_id="resp_abc123")

{
  "mcpServers": {
    "grok": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/grok-api-mcp/server",
        "python",
        "server.py"
      ],
      "env": {
        "XAI_API_KEY": "your_api_key_here"
      }
    }
  }
}

grok-api-mcp/
├── cli/
│   ├── src/
│   │   └── main.rs        # Rust CLI
│   └── Cargo.toml
├── server/
│   ├── server.py          # MCP server (Python/FastMCP)
│   ├── pyproject.toml
│   └── .env.example
├── skill.md               # Claude Code skill
└── README.md

{
  "model": "grok-4-1-fast-non-reasoning",
  "input": [
    {"role": "user", "content": "Your question"}
  ],
  "tools": [
    {"type": "web_search"}
  ]
}

{
  "model": "grok-4-1-fast-non-reasoning",
  "input": [
    {"role": "user", "content": "Your question"}
  ],
  "tools": [
    {
      "type": "x_search",
      "allowed_x_handles": ["elonmusk"],
      "from_date": "2025-01-01",
      "to_date": "2025-01-15",
      "enable_image_understanding": true,
      "enable_video_understanding": true
    }
  ]
}