Mcp Server Bridge

MCP Server Bridge

[中文](./README.md) | [English](./README.en.md)

一个模型上下文协议 (MCP) 服务器桥接器，允许动态注册简易的 CLI 工具及 HTTP 请求为 MCP 工具。

特性

• 动态工具注册：
• CLI 工具：可将注册环境中可用的 CLI 工具为 MCP 工具。
• HTTP 工具：将简易的 HTTP 端点注册为 MCP 工具。
• 配置持久化：
• CLI 工具作为 YAML 配置持久化。
• HTTP 工具作为 JSON 配置持久化。

项目结构

• src/mcp_server_bridge/：主要包源码。
• server.py：核心服务器逻辑和工具定义。
• config/：存储已注册工具配置 (YAML/JSON) 的目录。
• __init__.py：包导出。
• __main__.py：入口点。
• tests/：测试套件。

用法

连接到服务器

服务器运行 stdio 或 SSE 模式:

• -t sse 启动 SSE 模式
• -t stdio 或不指定参数则为 stdio 模式

"mcp-server-bridge": {
	"type": "stdio",
	"command": "uvx",
	"args": [
		"mcp-server-bridge"
	]
}

使用示例

注册 CLI 工具

注册一个 CLI 工具 fscan 为 MCP 工具：

CLI 工具使用:

注册 HTTP 工具

注册一个 HTTP 接口为 MCP 工具：

HTTP 工具使用:

其他工具

还可以通过 LLM 对话注册以下 API 和 CLI 工具等等：

• CLI：fscan, httpx, naabu, nmap, nuclei, subfinder
• HTTP：http://cip.cc

内置管理工具

1. get_cli_tool_help(command, help_flag):

• 获取 CLI 命令的帮助文本。
• 用于确定注册时的参数。

1. register_cli_tool(command, tool_description, tool_usage, tool_args):

• 注册一个新的 CLI 工具以通过 MCP 暴露。
• 在 src/mcp_server_bridge/config/ 中生成 YAML 配置。

1. register_http_tool(name, description, method, url, params, data, headers):

• 注册一个新的 HTTP 工具。
• 在 src/mcp_server_bridge/config/ 中生成 JSON 配置。

开发

1. 安装 uv（如果尚未安装）：

pip install uv

1. 安装依赖项和包：

uv sync

1. 运行服务器：

python src/mcp_server_bridge/server.py

1. 安装

uv tool install . --force

测试

uv run pytest

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: nu1lx
• Source: nu1lx/mcp-server-bridge
• License: MIT

Install and usage instructions live in the source repository linked above.