内容
cybertools-mcp-server
MCP（模型上下文协议）服务器，允许 AI Claude Code、Codex、Cursor、Continue 等）使用 [在线网络工具](https://onlinecybertools.com) 目录作为一组原生工具。
## 功能暴露
- 一个 MCP 工具对应一个文档 兼容 `/api/tools/{category}/{tool}` 操作。`POST` 工具使用其 JSON 请求体模式；兼容的 `GET`使用 OpenAPI 查询/路径参数。模式直接从网站的 3.1 规范中的 `/api/openapi.json` 获取可以获得每个工具的参数验证。当规范声明时，工具还 `annotations`（`title` 加 `readOnlyHint` / `destructiveHint` / `idempotentHint`，来源于 `x-annotations`）和 `outputSchema`（内联的 `200` 响应对象模式）。
- 一个 `search` 元工具与人类相同的关键词搜索，支持 `GET /api/tools/search?q`。
- 一个 `describe_tool` 元工具，从 `GET /api/mcp/tool-docs/{tool_id}` 获取长页面指南、、页面 URL、API 端点和 SEO 描述。它接受菜单 IDping`）或 MCP 工具名称（如 `network_ping- 一个 `report_bug` 元工具，向 `POST /apiug-report` 提交结构化的错误报告（严格限制速率）。
调用被代理到实时 HTTP API — 这里没有重新实现任何算法。这看到的内容与部署的网站相同。生成的工具描述是操作的 OpenAPI 摘要 + 描述，除了这些之外没有任何其他内容 — 没有菜单 ID 前缀或 `describe_tool` 指针（两者对调用代理噪音）。`describe_tool` 元工具仍然可用于需要完整页面指南的代理。
<!-- TOOLS:BEGIN (auto-generated by `php bin/console mcp:tools-doc`; do not edit by hand) -->
## 工具
此服务器在 15 个类别中暴露了 **279 个工具**：编码/解码、 二进制/文本转换、 加密和哈希、 网络开发工具、 文本工具、 OSINT 工具、 网络工具、 安全工具、 SEO 工具、 Linux 工具、 日期和时间、 数学和计算器、 数据工具、 文件工具、 逆向工程。
- **完整列表（此仓库）：** [`TOOLS.md`](./TOOLS.md) — 每个工具，按类别分组。
- **实时目录：** <https://onlinecybertools.com/#browse-the-full-inventory>
- **读规范：** <https://onlinecybertools.com/api/openapi.json>
- **选择子集/构建配置：** <https://onlinecybertools.com/integrations/mcp-plugin-builder>
本节和 `TOOLS.md` 每次发布时都会从实时菜单自动生成，因此计数和列表永远不会漂移。
<!-- TOOLS:END -->
## 快速入门
该软件包发布在 npm 上，名为 [`onlinecybertools-mcp-server`](https://www/package/onlinecybertools-mcp-server)，因此任何 MCP 客户端都可以通过 `npx -y onlinecybertools-mcp-server` 启动 — 无需克隆，无需全局安装。下面的配置代码段默认情况下可以正常工作，并公开 **完整的工具目录**。
更喜欢有导向的设置吗？从网站的交互式构建工具中生成一个现成的 Claude Code 插件或 Codex 配置块：
**<https://onlinecybertools.com/integrations/mcp-plugin-builder>**
构建工具允许您选择一组工具，并为您生成匹配的 `OCTOOLS_TOOLS` 过滤器（请参阅[配置](#配置)）。
## 配置
通过环境变量进行配置。所有变量都是可选的。
| 变量 | 默认值 | 目的 |
| --- | --- | --- |
| `OCTOOLS_BASE_URL` | `https://onlinecybertools.com` | 请求代理到的网站。 |
| `OCTOOLS_TOOLS` | _(未设置 → 所有工具)_ | 以逗号分隔的菜单 ID（`base64_encode,sha256,hash`）以限制暴露的表面。 **保持未设置以公开所有工具** — 下面的示例故意省略它。 |
| `OCTOOLS_STREAM_BYTE_CAP` | `262144`（256 KiB） | 从流式（`x-mcp-compatible: stream-buffered`）端点累积的最大字节数。 |
| `OCTOOLS_STREAM_TIME_CAP_MS` | `30000`（30 秒） | 缓冲流式端点所花费的最大时钟时间。 |
当设置 `OCTOOLS_TOOLS` 时，服务器在规范获取中追加 `?tools=...`，以便网站返回预过滤的规范；客户端还强制执行过滤作为防御深度。
## 运行
### 检查器（手动烟雾测试）
```bash
npx @modelcontextprotocol/inspector npx -y onlinecybertools-mcp-server
```
打开检查器 URL，点击 **列出工具** — 您应该看到 `search`、`describe_tool`、`report_bug`，以及每个兼容的 Symfony API 操作的条目。未设置 `OCTOOLS_TOOLS` 时，会列出完整的目录。
要在本地修改服务器，请克隆并从源代码运行：
```bash
git clone https://github.com/Jambozx/onlinecybertools-mcp-server.git
cd onlinecybertools-mcp-server
npm install
npx @modelcontextprotocol/inspector node index.mjs
```
### Claude Code
添加到 `~aude.json`（或项目的 `.mcp.json`）：
```json
{
"mcpServers": {
"octools": {
"command": "npx",
"args-y", "onlinecybertools-mcp-server"]
}
}
```
这公开了所有工具。要限制表面，请添加带有 `OCTOOLS_TOOLS` 的 `env` 块：
```json
{
"mcpServers": {
"octools": {
"command": "npx",
"args": ["-y", "onlinecybertools-mcp-server"],
"env": {
"OCTOOLS_TOOLS": "base64_encode,sha256,hash"
}
}
}
}
```
### Codex
添加到 `~/.codex/config.toml`：
```toml
[mcp_servers.octools]
command = "npx"
args = ["-y", "onlinecybertools-mcp-server"]
```
要限制表面，请添加带有 `OCTOOLS_TOOLS` 的 `env` 行：
```toml
[mcp_servers.octools]
command = "npx"
args = ["-y", "onlinecybertools-mcp-server"]
env = { OCTOOLS_TOOLSbase64_encode,sha256,hash" }
```
### Cursor / Continue / 通用 MCP 客户端
大多数客户端接受相同的 `command`/`args`/`env` 格式。通过 `npx -y onlinecybertools-mcp-server` 将它们指向此软件包。
## 流式端点
规范中标记为 `x-mcp-compatible: stream-buffered` 的端点（目前 traceroute 和 proxy-test 流）被读取到完成，并作为累积的 SSE 事件的单个 JSON 信封返回。GET 流端点将工具参数作为查询参数发送；POST 流发送 JSON 正文。硬上限：
- 256 KiB 的缓冲输出（`S_STREAM_BYTE_CAP- 30 秒的`OCTOOLS_STREAM_TIME_CAP_MS`）
无论哪个上限先触发，响应都包含 `{ "truncated": true }`，以便代理知道输出不完整为 `x-mcp-compatible: none` 的端点 文件上传等）在注册时**跳过** — 出现在 `tools/list` 中。
## 限制
- 启动时**获取。如果网站添加新的，请重启服务器。
- 仅支持 stdio 传输；没有 HTTP 服务器（避免在特点前面进行身份验证）。
- 发布到 npm 为 `onlinecybertools-mcp-server`（`npx -y onlinecybertools-mcp-server`）。直接从 GitHub 安装（`npx -y github:Jambozx/onlinecybertools-mcp-server`）仍然适用于最新版本。
## 许可证
MIT。
