内容
# Grok HTTP MCP Server
> [!WARNING]
> **本项目已归档 (Archived)**
>
> 归档原因：作者认为这个项目没啥价值，有点傻。不再进行任何维护与更新。
[](https://www.gnu.org/licenses/gpl-3.0)
[English](README.en.md)
基于 Cloudflare Workers 的 MCP 服务器，为 Grok 提供底层 HTTP 能力，适用于 Web/CTF 场景：任意请求、Cookie 会话持久化、重定向追踪与结构化响应。
## 功能特性
- **`http_request`** — 发送任意 HTTP 方法，完全控制 URL、Header、Body、Cookie
- **`http_session`** — 管理命名 Cookie 容器（`default`、`victim`、`attacker` 等）
- **会话持久化** — 通过 Durable Objects 跨多次 tool call 保持 Cookie
- **双传输协议** — Streamable HTTP（`/mcp`）与旧版 SSE（`/sse`）
- **默认无鉴权** — 便于 CTF/测试快速接入（见下方安全说明）
## 快速开始
```bash
npm install
npx wrangler login
npm run dev
```
健康检查：`http://127.0.0.1:8787/health`
部署：
```bash
npm run deploy
```
部署完成后会显示 Worker 地址（例如 `https://grok2web.<account>.workers.dev`）。
## Grok 自定义连接器
1. 打开 [grok.com/connectors](https://grok.com/connectors)
2. 点击 **New Connector** → **Custom**（新建连接器 → 自定义）
3. 填入以下 URL 之一：
- **推荐：** `https://<your-worker>.workers.dev/mcp`
- **SSE 兼容：** `https://<your-worker>.workers.dev/sse`
4. 填写名称（如 `Grok HTTP MCP`）并保存
Grok 会自动发现 `http_request` 和 `http_session` 两个工具。
## 工具说明
### `http_request`
```json
{
"method": "POST",
"url": "https://target.example/login",
"headers": { "Content-Type": "application/x-www-form-urlencoded" },
"body": "user=admin&pass=test",
"http_session_id": "default",
"follow_redirects": true,
"timeout_ms": 30000
}
```
返回字段包括：`status`、`headers`、`cookies_set`、`cookies_jar`、`body`、`redirect_chain`、`timing_ms`。
### `http_session`
| action | 说明 |
|--------|------|
| `list` | 列出所有会话及 Cookie 数量 |
| `create` | 创建命名空 Cookie 容器 |
| `reset` | 清空指定会话的 Cookie |
| `get_cookies` | 读取全部 Cookie（含 domain/path 元数据） |
| `set_cookies` | 手动注入 Cookie |
| `delete` | 删除命名会话（不可删除 `default`） |
## CTF 示例流程
**步骤 1 — 设置 Cookie：**
```json
{
"method": "GET",
"url": "https://httpbin.org/cookies/set?session=abc123"
}
```
**步骤 2 — 验证持久化：**
```json
{
"method": "GET",
"url": "https://httpbin.org/cookies"
}
```
第二次请求会自动携带 `session=abc123`。
**并行会话（多角色攻击链）：**
```json
{ "action": "create", "session_id": "victim" }
```
之后在 `http_request` 中使用 `"http_session_id": "victim"`。
## 本地测试
```bash
npm run verify # MCP + Cookie 持久化测试
npx @modelcontextprotocol/inspector
```
连接 `http://127.0.0.1:8787/mcp`，在 UI 中调用工具。
## 安全说明
当前部署**无鉴权**。任何知道 URL 的人均可通过 Worker 发送 HTTP 请求。仅建议用于 CTF 实验和测试环境；生产使用前请添加 API Key 或 OAuth。
## 项目结构
```
src/
├── index.ts # /mcp、/sse、/health 路由
├── mcp-agent.ts # GrokHttpMCP（McpAgent + DO 状态）
├── tools/
│ ├── http-request.ts
│ └── http-session.ts
└── lib/
├── cookie-jar.ts
├── http-client.ts
├── response-format.ts
└── session-store.ts
```
## 许可证
本项目采用 [GNU General Public License v3.0 或更高版本](LICENSE) 授权。
