My Cool Proxy

我的酷代理

](https://www.npmjs.com/package/@karashiiro/my-cool-proxy)

我的酷代理是 模型上下文协议（MCP） 服务器网关试图解决MCP目前存在的许多感知问题。没有特别的顺序，这些是：

• 工具描述使上下文窗口膨胀： 这是大多数代理如何与MCP集成的问题。大多数应用程序不是实现抽象，使工具能够根据需要加载，而是一次将所有MCP工具转储到上下文中。为了缓解这种情况，My Cool Proxy将工具封装在Lua解释器中，并公开了用于增量发现工具的高级工具。参见 渐进式披露 了解更多信息。
• 工具结果使上下文窗口膨胀，为什么不使用Bash？ 代理可以直接执行终端命令并使用bash过滤结果，而不是使用MCP工具，但这意味着允许代理更频繁地执行高风险操作。例如，您可以允许代理使用 gh CLI可以与GitHub交互，但它可以使用 gh CLI也可以执行变异或破坏性操作。随着 ，你可以把事情简单地归结为只读工具。MCP允许您严格控制代理可以访问的工具。为了帮助您做到这一点，My Cool Proxy允许您 进一步过滤器 暴露在特工面前的工具。
• 大多数MCP功能不受支持： 不幸的是，大多数应用程序只将MCP工具暴露给代理，而忽略了其他工具 客户端 和 服务器 协议提供的功能。My Cool Proxy旨在成为尽可能多的协议功能的通用抽象层，使开发人员能够在任何兼容MCP的应用程序中使用MCP的全部功能。这是一项正在进行的工作-请检查 功能支持表 了解更多详情。
• 管理多个代理的配置文件很痛苦： 如果您使用多个兼容MCP的应用程序，您很快就会遇到保持MCP服务器配置在它们之间同步的挑战。My Cool Proxy通过充当您使用的每台服务器的单个集成点来解决这个问题，将需要保持同步的服务器数量减少到只有一台。

快速开始

0.安装

全局安装以将其用作CLI工具：

npm install -g @karashiiro/my-cool-proxy

或者直接通过运行 npx:

npx @karashiiro/my-cool-proxy

1.配置

网关 自动创建默认配置 第一次跑步。只需运行一次即可生成配置文件：

my-cool-proxy  # Creates config and starts (with no servers)

# Find your config location
my-cool-proxy --config-path

然后 编辑配置 添加您的MCP服务器。

配置结构示例：

{
  "port": 3000,
  "host": "localhost",
  "mcpClients": {
    "my-server": {
      "type": "http",
      "url": "https://example.com/mcp"
    }
  }
}

或，复制 示例配置 以获得更完整的起点。

2.跑步

# If installed globally
my-cool-proxy

# If running via npx
npx @karashiiro/my-cool-proxy

3.连接

将其添加到您的MCP客户端配置中，例如Claude Desktop：

{
  "mcpServers": {
    "my-cool-proxy": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

4.使用它

让您的代理执行您配置的MCP服务器可以帮助的任务，并观察它的运行！

渐进式披露

此代理充当代理和多个MCP（模型上下文协议）服务器之间的网关。代理不是单独连接到每个MCP服务器，而是连接到这个单一的代理，并通过统一的接口访问所有配置的服务器。

代理在开始时对可用的服务器或工具知之甚少。他们逐步构建上下文：

1. 查看服务器说明-My Cool Proxy会预加载一个小提示，其中包含配置的服务器和工具的简短摘录，以引导代理使用它们。
2. 呼叫 list-servers -代理的上下文现在包括所有可用MCP服务器的名称和描述（例如，“github”、“lack”、“数据库”）
3. 呼叫 list-server-tools(server_name) -代理的上下文扩展到包括该特定服务器的所有工具名称和描述
4. 呼叫 tool-details(server_name, tool_name) -代理的上下文现在具有完整的参数模式、返回类型（如果可用）和特定工具的使用示例
5. 呼叫 execute(lua_script) -在完整上下文中，代理可以编写调用所发现工具的Lua脚本

这不是将所有工具和工具描述预先加载到上下文中，而是推迟加载工具，直到代理确定需要这些工具。

Lua工具链： 一旦代理知道存在哪些工具，他们就可以在单个工具中组合复杂的多步骤工作流 execute() 调用，节省任何中间工具结果的上下文开销。Lua运行时提供对所有发现的服务器的全局访问，工具可作为异步函数调用。

顺序工具链：

local raw_data = api_server.fetch({ id = 123 }):await()
local processed = processor.transform({ input = raw_data }):await()
result(processed)

条件逻辑：

local status = checker.validate({}):await()
if status.ok then
  result(processor.run({}):await())
else
  result(error_handler.notify({ error = status.message }):await())
end

循环迭代：

local results = {}
for i = 1, 5 do
  results[i] = worker.process({ index = i }):await()
end
result({ total = #results, data = results })

网关技能

网关技能是My Cool Proxy的实现 代理技能 -代理可以加载的可重用上下文文档 MCP资源。启用后，代理可以：

• 通过网关服务器指令中自动注入的提示（或通过 _gateway.list_resources() Lua内置；寻找 gw-skill:// URI）
• 通过阅读技能内容 _gateway.read_resource() Lua内置
• 通过执行技能脚本 _gateway.invoke_skill_script() Lua内置

虽然许多代理已经实现了自己的技能系统，但这些系统高度分散，很难在多个单独的代理应用程序中重用相同的技能。虽然一些系统，如 技能s.sh My Cool Proxy通过在应用程序之间显式复制技能来解决这个问题，它将所有技能集中到自己的技能管理系统中，并通过MCP公开这些技能。为了将这些技能系统与现有的技能系统区分开来，My Cool Proxy将这些技能称为“网关技能”

默认情况下，网关技能被禁用，因为它们可能与代理中内置的现有技能系统冲突。看 配置指南 有关设置选项。

有关网关技能为何以这种方式实现的更深入的设计讨论，请参阅 本节 在设计文档中。

Web仪表板

My Cool Proxy包括一个可选的网络仪表板，用于监控网关活动。启用后，它在单独的端口上运行，并提供：

• 执行历史 --浏览所有Lua脚本执行，语法突出显示脚本和结果
• 工具调用日志 --查看每次执行期间调用了哪些MCP工具
• 会话监控 --查看活动会话、连接的服务器和功能
• 实时更新 --新的执行通过WebSocket流式传输到仪表板

通过添加一个 dashboard 部分到您的配置：

{
  "dashboard": {
    "port": 3100,
    "host": "localhost"
  }
}

然后访问 http://localhost:3100 在您的浏览器中。看 配置指南 了解详情。

配置

看 配置指南 获取完整的配置参考。

MCP功能支持表