内容
# 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)
MCP 市场