contextX is a remote MCP server that provides web search via Grok 4.3 Fast by streaming queries to an OpenAI-compatible Responses API and returning the answer body as an MCP tool result.

Stars

29

7-day growth

No data

Forks

2

Open issues

0

License

No data

Last updated

2026-08-01

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It offers a ready-to-use hosted MCP endpoint that requires no client-side installation or API key, while also supporting self-hosting with your own API key.

Who it is for

  • Developers using MCP-compatible clients such as Claude Code, Cursor, or Pi Agent
  • Teams that want hosted web-search tooling without managing API keys
  • Developers interested in self-hosting a Rust-based MCP server
  • Users who need a simple remote MCP search endpoint

Use cases

  • Add web search to Claude Code through a remote MCP endpoint
  • Add web search to Cursor or Pi Agent via MCP
  • Self-host a private Grok-powered search MCP server
  • Prototype MCP integrations with an OpenAI-compatible Responses API

Strengths

  • Public endpoint is ready to use without client-side installation or API key
  • Streaming upstream responses helps avoid gateway wait timeouts
  • Supports multiple MCP clients including Pi Agent, Claude Code, and Cursor
  • Self-hostable with configurable environment variables

Considerations

  • Currently no authentication is implemented for MCP users, so a public deployment is open to anyone who can reach it
  • The model is fixed to Grok 4.3 Fast and users cannot change it
  • Only one MCP tool, grok_search, is provided

README quick start

contextX

日本語 | 简体中文

contextXは、Grok 4.3 Fastを利用してウェブ検索を行うリモートMCPサーバーです。

MCPクライアントから受け取った検索クエリをOpenAI互換のResponses APIへストリーミング送信し、回答本文をMCPのツール結果として返します。上流ストリームを継続的に受信することで、検索処理中に発生するゲートウェイの待機タイムアウトを抑制します。利用者がモデルを変更することはできません。

公開エンドポイント: https://mcp.twitter.monster/mcp

MCPクライアントへの追加

contextXはリモートMCPサーバーです。利用者側でバイナリをインストールしたり、APIキーを用意したりする必要はありません。

Pi Agent

Pi本体にはMCP機能が組み込まれていないため、最初にMCPアダプターをインストールします。

pi install npm:pi-mcp-adapter

Piを再起動し、~/.config/mcp/mcp.jsonmcpServersへ次の設定を追加します。既存のMCP設定がある場合は上書きせず、contextXの項目だけをマージしてください。

{
  "mcpServers": {
    "contextX": {
      "url": "https://mcp.twitter.monster/mcp",
      "lifecycle": "lazy",
      "requestTimeoutMs": 360000
    }
  }
}

Piで接続を確認します。

/mcp reconnect contextX

Claude Code

claude mcp add --transport http contextX https://mcp.twitter.monster/mcp

Claude Code内の/mcpで接続状態を確認できます。

Cursor

ユーザー全体の~/.cursor/mcp.json、またはプロジェクト内の.cursor/mcp.jsonへ追加します。

{
  "mcpServers": {
    "contextX": {
      "url": "https://mcp.twitter.monster/mcp"
    }
  }
}

その他のMCPクライアント

Streamable HTTP対応クライアントに、次のURLをリモートMCPサーバーとして登録してください。認証ヘッダーやトークンは不要です。

https://mcp.twitter.monster/mcp

セルフホスト

以下は、自分のAPIキーを使ってcontextXサーバーを運用する場合の手順です。

ディレクトリ構成

src/
├── main.rs    # エントリーポイント
├── config.rs  # 環境変数と起動設定
├── grok.rs    # Grok上流APIクライアント
├── mcp.rs     # MCPツールとサーバー情報
└── server.rs  # Streamable HTTPサーバー

セットアップ

.env.exampleをコピーします。

cp .env.example .env

.envに上流APIキーとResponses APIの完全なエンドポイントを設定してください。実際の上流URLをソースコードや公開リポジトリへ記載しないでください。

GROK_API_KEY=your-api-key
GROK_UPSTREAM_URL=https://your-upstream.example/v1/responses

起動

cargo run

デフォルトでは次のURLで待ち受けます。

MCP:    http://127.0.0.1:3000/mcp
Health: http://127.0.0.1:3000/health

環境変数

変数必須説明
GROK_API_KEYはい上流APIのBearerトークン
GROK_UPSTREAM_URLはいOpenAI互換のResponses APIエンドポイント。ソースコード内に既定値はありません
BIND_ADDRいいえサーバーの待受アドレス。デフォルトは0.0.0.0:3000
MCP_ALLOWED_HOSTSいいえ受け入れるHostのカンマ区切りリスト

公開時はMCP_ALLOWED_HOSTSに実際のドメインを追加してください。

MCP_ALLOWED_HOSTS=localhost,127.0.0.1,::1,mcp.twitter.monster

MCPツール

grok_search

Grok 4.3 Fastでウェブ検索し、質問に回答します。

入力例:

{
  "query": "Rustの

Related repositories

Similar projects matched by category, topics, and programming language.

l0ng-ai
Featured
l0ng-ai GitHub avatar

tty7

tty7 is a fast, GPU-accelerated terminal workbench with persistent sessions, built-in input tools, SSH support, and coding agent awareness.

Developer ToolsCLI & Terminal
359
l00sed
Featured
l00sed GitHub avatar

termixer

A terminal-based DJ mixer written in Rust for live TidalCycles performances, providing dual-deck mixing, EQ/filtering, crossfader, and sample pads via MPV and SuperCollider.

Rust
148
steelbrain
Featured
steelbrain GitHub avatar

reims-vgpu

reims-vgpu is an experimental virtual GPU for macOS guests that uses QEMU to decode the guest's GPU command stream and execute it through Metal or Vulkan, leveraging the built-in AppleParavirtGPU driver without requiring custom kexts.

Desktop Apps
143