AI导哈

MCP代理包装器

MCP代理包装器是一个无需修改原始代码即可为现有MCP服务器添加钩子、插件和自定义逻辑的工具，适用于AI集成、安全增强和服务器功能扩展。

  • by dennisonbertram
  • HTML
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 dennisonbertram/mcp-proxy-wrapper

使用说明

🚀 MCP代理包装器

在不更改代码的情况下，将钩子和插件添加到任何MCP服务器

📖 完整的文件 • 🚀 快速开始 • 🔌 插件 • 🏗️ 例子

一种代理包装器，在不修改原始代码的情况下，向现有的MCP服务器添加钩子、插件和自定义逻辑。

🚀 快速开始

安装

npm install mcp-proxy-wrapper

适用于克劳德代码和克劳德桌面

选项1：直接服务器配置

创建一个包装好的MCP服务器，并在Claude中对其进行配置：

// server.js
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { wrapWithProxy, LLMSummarizationPlugin } from 'mcp-proxy-wrapper';

const server = new McpServer({ name: 'Enhanced Server', version: '1.0.0' });

// Add your tools
server.tool('getData', schema, getData);

// Add proxy wrapper with plugins
const plugin = new LLMSummarizationPlugin();
plugin.updateConfig({
  options: {
    provider: 'openai',
    openaiApiKey: process.env.OPENAI_API_KEY
  }
});

const enhanced = await wrapWithProxy(server, {
  plugins: [plugin],
  hooks: {
    beforeToolCall: async (context) => {
      console.log(`🔧 ${context.toolName}`);
    }
  }
});

// Start the server
enhanced.start(process.stdin, process.stdout);

然后添加到克劳德代码中：

# Add to local project
claude mcp add enhanced-server node /path/to/server.js

# Add to all projects (user scope)  
claude mcp add enhanced-server --scope user node /path/to/server.js

# Add to team projects (project scope)
claude mcp add enhanced-server --scope project node /path/to/server.js

选项2：代理现有服务器

无需修改即可增强现有的MCP服务器：

// proxy-server.js
import { createStdioServerProxy, LLMSummarizationPlugin } from 'mcp-proxy-wrapper';

const plugin = new LLMSummarizationPlugin();
plugin.updateConfig({
  options: { openaiApiKey: process.env.OPENAI_API_KEY }
});

// Proxy an existing server and add features
const proxy = await createStdioServerProxy({
  command: 'npx',
  args: ['@modelcontextprotocol/server-filesystem', '/tmp'],
  plugins: [plugin],
  hooks: {
    beforeToolCall: async (context) => {
      // Add authentication, logging, etc.
      console.log(`Tool called: ${context.toolName}`);
    }
  }
});

proxy.start(process.stdin, process.stdout);

在Claude代码中配置：

claude mcp add filesystem-enhanced node /path/to/proxy-server.js

基本用法

import { wrapWithProxy, LLMSummarizationPlugin } from 'mcp-proxy-wrapper';

// Your existing server - no changes needed
const server = new McpServer({ name: 'My Server', version: '1.0.0' });
server.tool('getData', schema, getData);

// Add plugins and hooks
const plugin = new LLMSummarizationPlugin();
plugin.updateConfig({
  options: {
    provider: 'openai',
    openaiApiKey: process.env.OPENAI_API_KEY
  }
});

const enhanced = await wrapWithProxy(server, {
  plugins: [plugin],
  hooks: {
    beforeToolCall: async (context) => {
      console.log(`🔧 ${context.toolName}`);
      // Add auth, rate limiting, etc.
    }
  }
});

结果：您的服务器现在具有AI摘要、日志记录和自定义挂钩，无需任何代码更改。

✨ 主要特点

  • 🔧 零代码更改 -立即包装现有服务器
  • 🤖 人工智能集成 -基于OpenAI的响应摘要
  • 🪝 钉钩系统 -完全控制ToolCall之前/之后
  • 🔌 插件架构 -可重用、可组合的功能
  • 🌐 远程服务器 -通过HTTP/WebSocket代理外部MCP服务器
  • 🛡️ 身份验证和安全 -身份验证、速率限制、访问控制模式
  • 📊 综合测试 -273项测试，涵盖MCP协议兼容性

📖 例子

身份验证和速率限制

const secure = await wrapWithProxy(server, {
  hooks: {
    beforeToolCall: async (context) => {
      if (!await validateApiKey(context.args.apiKey)) {
        return { result: { content: [{ type: 'text', text: 'Unauthorized' }], isError: true }};
      }
    }
  }
});

AI驱动的总结

const plugin = new LLMSummarizationPlugin();
plugin.updateConfig({
  options: {
    provider: 'openai',
    openaiApiKey: process.env.OPENAI_API_KEY,
    summarizeTools: ['research', 'analyze']
  }
});

const intelligent = await wrapWithProxy(server, {
  plugins: [plugin]
});

远程服务器代理

// Proxy external servers and add features
const plugin = new LLMSummarizationPlugin();
plugin.updateConfig({
  options: {
    provider: 'openai',
    openaiApiKey: process.env.OPENAI_API_KEY
  }
});

const proxy = await createHttpServerProxy('https://api.example.com/mcp', {
  plugins: [plugin],
  hooks: { /* your custom logic */ }
});

🧪 技术细节

  • 273项测试通过 具有真正的MCP客户端-服务器通信
  • 全面的错误处理 具有回退和适当的错误传播
  • TypeScript原生 具有完全类型安全和IntelliSense
  • MCP SDK v1.6.0+ 与任何现有服务器兼容

📚 文档

📖 完整的文件→

🤝 贡献

欢迎投稿！看 贡献指南 了解详情。

git clone https://github.com/mcp-plugins/mcp-proxy-wrapper.git
cd mcp-proxy-wrapper && npm install && npm test

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

Built for the MCP ecosystem • Dennison Bertram

相关 MCP