Back to search
ContextX
SkillGitHub
A free remote MCP server offering normal (Grok 4.3) and deep (Grok 4.20 Multi-Agent) search. No API keys required, streaming support prevents gateway timeouts.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/akasakariko--contextx)HTML
<a href="/listings/akasakariko--contextx"><img src="/api/listings/akasakariko--contextx/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 191 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # contextX
- **日本語** | [简体中文](README.zh-CN.md) | [English](README.en.md)
- contextXは、Grok 4.3による通常検索とGrok 4.20 Multi-Agent 0309による深度検索を提供するリモートMCPサーバーです。
- MCPクライアントから受け取った検索クエリをOpenAI互換のResponses APIへストリーミング送信し、回答本文をMCPのツール結果として返します。上流ストリームを継続的に受信することで、検索処理中に発生するゲートウェイの待機タイムアウトを抑制します。利用者がモデルを変更することはできません。
- **公開エンドポイント:** `https://mcp.twitter.monster/mcp`
- ## MCPクライアントへの追加
- contextXはリモートMCPサーバーです。利用者側でバイナリをインストールしたり、APIキーを用意したりする必要はありません。
- ### Pi Agent
- Pi本体にはMCP機能が組み込まれていないため、最初にMCPアダプターをインストールします。
- ```bash
- pi install npm:pi-mcp-adapter
- ```
- Piを再起動し、`~/.config/mcp/mcp.json`の`mcpServers`へ次の設定を追加します。既存のMCP設定がある場合は上書きせず、`contextX`の項目だけをマージしてください。
- ```json
- {
- "mcpServers": {
- "contextX": {
- "url": "https://mcp.twitter.monster/mcp",
- "lifecycle": "lazy",
- "requestTimeoutMs": 360000
- }
- }
- }
- ```
- Piで接続を確認します。
- ```text
- /mcp reconnect contextX
- ```
- #### Pi Subagents
- `pi-subagents`で`tools`を宣言した子エージェントは厳格な許可リストを使用するため、親エージェントのMCPツールを自動継承しません。ウェブアクセスが必要なagent定義へ`mcp:contextX`を追加するか、`~/.pi/agent/settings.json`で組み込みagentを上書きしてください。
- ```json
- {
- "subagents": {
- "agentOverrides": {
- "researcher": {
- "tools": ["read", "write", "intercom", "mcp:contextX"]
- }
- }
- }
- }
- ```
- ウェブアクセスが必要な他のagentにも`mcp:contextX`を追加します。最初に`/mcp reconnect contextX`でツールキャッシュを作成してからPiを再起動してください。子エージェントでは`contextX_grok_search`と`contextX_grok_deep_search`を直接利用できます。
- ### Claude Code
- ```bash
- claude mcp add --transport http contextX https://mcp.twitter.monster/mcp
- ```
- Claude Code内の`/mcp`で接続状態を確認できます。
- ### Cursor
- ユーザー全体の`~/.cursor/mcp.json`、またはプロジェクト内の`.cursor/mcp.json`へ追加します。
- ```json
- {
- "mcpServers": {
- "contextX": {
- "url": "https://mcp.twitter.monster/mcp"
- }
- }
- }
- ```
- ### その他のMCPクライアント
- Streamable HTTP対応クライアントに、次のURLをリモートMCPサーバーとして登録してください。認証ヘッダーやトークンは不要です。
- ```text
- https://mcp.twitter.monster/mcp
- ```
- ## セルフホスト
- 以下は、自分のAPIキーを使ってcontextXサーバーを運用する場合の手順です。
- ### ディレクトリ構成
- ```text
- src/
- ├── main.rs # エントリーポイント
- ├── config.rs # 環境変数と起動設定
- ├── grok.rs # Grok上流APIクライアント
- ├── mcp.rs # MCPツールとサーバー情報
- └── server.rs # Streamable HTTPサーバー
- ```
- ### セットアップ
- `.env.example`をコピーします。
- ```bash
- cp .env.example .env
- ```
- `.env`に上流APIキーとResponses APIの完全なエンドポイントを設定してください。実際の上流URLをソースコードや公開リポジトリへ記載しないでください。
- ```env
- GROK_API_KEY=your-api-key
- GROK_UPSTREAM_URL=https://your-upstream.example/v1/responses
- GROK_DEEP_API_KEY=your-deep-search-api-key
- GROK_DEEP_UPSTREAM_URL=https://your-deep-upstream.example/v1/responses
- ```
- ### 起動
- ```bash
- cargo run
- ```
- デフォルトでは次のURLで待ち受けます。
- ```text
- MCP: http://127.0.0.1:3000/mcp
- Health: http://127.0.0.1:3000/health
- ```
- ### 環境変数
- | 変数 | 必須 | 説明 |
- |---|---:|---|
- | `GROK_API_KEY` | はい | 通常検索上流APIのBearerトークン |
- | `GROK_UPSTREAM_URL` | はい | 通常検索上流のResponses APIエンドポイント |
- | `GROK_DEEP_API_KEY` | はい | 深度検索上流APIのBearerトークン |
- | `GROK_DEEP_UPSTREAM_URL` | はい | 深度検索上流のResponses APIエンドポイント |
- | `BIND_ADDR` | いいえ | サーバーの待受アドレス。デフォルトは`0.0.0.0:3000` |
- | `MCP_ALLOWED_HOSTS` | いいえ | 受け入れるHostのカンマ区切りリスト |
- 公開時は`MCP_ALLOWED_HOSTS`に実際のドメインを追加してください。
- ```env
- MCP_ALLOWED_HOSTS=localhost,127.0.0.1,::1,mcp.twitter.monster
- ```
- ## MCPツール
- 公開サービスでは、どちらのツールも認証や利用回数制限なしで利用できます。モデルや設定ファイルを変更する必要はなく、利用者が依頼内容によって検索方法を選択できます。
- ### `grok_search`
- Grok 4.3で高速な通常検索を実行します。日常的な質問や簡単な情報確認に適しています。
- 入力例:
- ```json
- {
- "query": "Rustの最新安定版について調べてください"
- }
- ```
- ### `grok_deep_search`
- Grok 4.20 Multi-Agent 0309で包括的な深度検索を実行します。通常検索より時間がかかるため、詳細な調査が必要な場合に使用してください。
- 入力例:
- ```json
- {
- "query": "Rustの非同期ランタイムについて複数の情報源を比較し、詳細に調査してください"
- }
- ```
- MCPクライアントでは、「深度検索を使用してください」と明示することで深度検索ツールを選択できます。
- ## セキュリティ
- - 上流APIキーはサーバー側だけに保存します。
- - `.env`はGitの管理対象外です。
- - 現在、MCP利用者に対する認証は行いません。
- ## 友情链接
- - [LINUX DO](https://linux.do)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.