Online Cyber Tools Mcp

onlinecybertools-mcp-server

MCP（Model Context Protocol）服务，让 AI Agent（Claude Code、Codex、 Cursor、Continue 等）能够将 Online Cyber Tools 工具目录作为一组 原生 MCP 工具使用。

提供的功能

• 每个有文档记录且兼容 MCP 的 /api/tools/{category}/{tool} 操作都对应一个 MCP 工具。POST 工具使用其 JSON 请求体架构；兼容的 GET 工具使用 OpenAPI 查询／路径参数。架构直接取自网站的 OpenAPI 3.1 规范 /api/openapi.json，因此 Agent 可对每个工具的参数进行验证。如果规范中有声明，工具还会附带 MCP annotations（title 加上 readOnlyHint / destructiveHint / idempotentHint，来源于 x-mcp-annotations） 以及 outputSchema（内联的 200 响应对象架构）。
• 一个 search 元工具，使用与人类相同的关键词搜索，后端由 GET /api/tools/search?q=... 提供支持。
• 一个 describe_tool 元工具，通过 GET /api/mcp/tool-docs/{tool_id} 获取详细页面指南、源链接、页面 URL、API 端点和 SEO 描述。 它接受菜单 ID（如 ping）或 MCP 工具名称（如 network_ping）。
• 一个 report_bug 元工具，可通过 POST /api/agent/bug-report 提交结构化错误报告（有严格的速率限制）。

调用会代理到实时 HTTP API — 不会在此重新实现任何算法。 这能确保 Agent 看到的内容与已部署网站上的行为一致。 生成的工具描述仅包含该操作的 OpenAPI 摘要和描述，不含其他内容 — 不添加菜单 ID 前缀或 describe_tool 提示（调用中的 Agent 会将两者视为噪声）。对于需要按需获取完整页面指南的 Agent，仍可使用 describe_tool 元工具。

工具

此服务在 15 个类别中提供 279 个工具： 编码／解码、二进制／文本转换、密码学与哈希、Web 开发实用工具、文本实用工具、OSINT 工具、网络工具、安全工具、SEO 工具、Linux 工具、日期与时间、数学与计算器、数据工具、文件工具、逆向工程。

• 完整列表（本仓库）： TOOLS.md — 按类别列出每个工具。
• 在线目录： https://onlinecybertools.com/#browse-the-full-inventory
• 机器可读规范： https://onlinecybertools.com/api/openapi.json
• 选择工具子集／构建配置： https://onlinecybertools.com/integrations/mcp-plugin-builder

本节和 TOOLS.md 会在每次发布时根据在线菜单自动生成，因此工具数量和列表始终保持同步。

快速开始

此软件包已发布到 npm，名称为 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	(unset → all 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 s)	缓冲流式端点所花费的最长实际时间。

设置 OCTOOLS_TOOLS 后，服务会在获取规范的请求中附加 ?tools=...， 以便站点返回预先筛选过的规范；客户端也会执行筛选，作为纵深防御。

运行

Inspector（手动冒烟测试）

npx @modelcontextprotocol/inspector npx -y onlinecybertools-mcp-server

打开 Inspector URL，点击 List Tools——你应该会看到 search、 describe_tool、report_bug，以及每个兼容的 Symfony API 操作各自对应的一项。如果未设置 OCTOOLS_TOOLS，则会列出完整目录。

若要改为在本地开发此服务，请克隆仓库并从源代码运行：

git clone https://github.com/Jambozx/onlinecybertools-mcp-server.git
cd onlinecybertools-mcp-server
npm install
npx @modelcontextprotocol/inspector node index.mjs

Claude Code

添加到 ~/.claude.json（或项目的 .mcp.json）：

{
  "mcpServers": {
    "octools": {
      "command": "npx",
      "args": ["-y", "onlinecybertools-mcp-server"]
    }
  }
}

这会公开所有工具。若要限制公开范围，请添加包含 OCTOOLS_TOOLS 的 env 块：

{
  "mcpServers": {
    "octools": {
      "command": "npx",
      "args": ["-y", "onlinecybertools-mcp-server"],
      "env": {
        "OCTOOLS_TOOLS": "base64_encode,sha256,hash"
      }
    }
  }
}

Codex

添加到 ~/.codex/config.toml：

[mcp_servers.octools]
command = "npx"
args = ["-y", "onlinecybertools-mcp-server"]

若要限制公开范围，请添加包含 OCTOOLS_TOOLS 的 env 行：

[mcp_servers.octools]
command = "npx"
args = ["-y", "onlinecybertools-mcp-server"]
env = { OCTOOLS_TOOLS = "base64_encode,sha256,hash" }

Cursor / Continue / 通用 MCP 客户端

大多数客户端都接受相同的 command/args/env 结构。通过 npx -y onlinecybertools-mcp-server 指向此软件包。

流式端点

规范中标记为 x-mcp-compatible: stream-buffered 的端点（目前为 traceroute 和 proxy-test 流）会被读取至完成，并以单个 JSON 信封的形式返回累积的 SSE 事件。GET 流式端点通过查询参数传递工具参数；POST 流则发送 JSON 请求体。硬性上限：

• 缓冲输出为 256 KiB（OCTOOLS_STREAM_BYTE_CAP）
• 实际时间为 30 s（OCTOOLS_STREAM_TIME_CAP_MS）

无论哪个上限先触发，响应信封都会包含 { "truncated": true }，以便 Agent 知道输出不完整。

标记为 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.