MCP Proxy Monorepo

MCP代理Monorepo


基于stdio的MCP（模型上下文协议）服务器的HTTP代理集合，使用共享的通用代理包构建。

______________________________________________________________________

展示示例

此monorepo包括示例实现，展示了代理的多功能性：

注： 这些都是展示性的例子。您可以通过遵循所示的配置模式，使代理适应任何基于stdio的MCP服务器。

______________________________________________________________________

🚀 快速开始

Hevy（展示示例）

→ 包/mcp http代理/QUICKSTART.md --完整设置指南

启动顺序（重要）：

1. 跑 .\packages\mcp-http-proxy\START_HEVY_DUAL_MODE.bat 第一
2. 然后 启动克劳德代码CLI
3. 工具将立即可用

LibreOffice（展示示例）

→ --完整的设置指南

适用于任何MCP服务器

# Clone and install
git clone https://github.com/RhoMancer/mcp-proxy-monorepo.git
cd mcp-proxy-monorepo
npm install

# Configure your MCP server
cp packages/mcp-http-proxy/examples/echo-test.config.js my-config.js
# Edit my-config.js with your MCP server details

# Start the proxy
cd packages/mcp-http-proxy
npx mcp-proxy --config ../my-config.js

______________________________________________________________________

概述

此monorepo包含：

• mcp-http-proxy -任何MCP服务器的通用HTTP到stdio代理

- 配置驱动的MCP服务器生成 - OAuth 2.0提供程序模式，用于安全远程访问 - CORS支持、健康检查、Cloudflare隧道支持

• libreoffice-calc-mcp -LibreOffice Calc的HTTP代理+MCP服务器

- 11个用于电子表格自动化的MCP工具 - 在套接字模式下自动启动LibreOffice

• libreoffice-calc-mcp-server -Python MCP服务器实现

- 演示MCP服务器模式

______________________________________________________________________

包裹

mcp-http代理

适用于任何MCP服务器的通用HTTP到stdio代理。

特征：

• 配置驱动的MCP服务器生成
• HTTP/JSON-RPC到stdio的桥接
• OAuth 2.0提供程序模式，用于安全远程访问
• 浏览器客户端的CORS支持
• 健康检查和列出端点的工具
• Cloudflare隧道配置支持

用途：

cd packages/mcp-http-proxy
npm install

# Use the echo test server (great for OAuth testing!)
npx mcp-proxy --config examples/echo-test.config.js

# Or with Hevy:
npx mcp-proxy --config examples/hevy-mcp.config.js

# With OAuth Provider mode:
npx mcp-proxy --config examples/echo-oauth-test.config.js

文档：

• QUICKSTART.md -Hevy示例设置
• DUAL_MODE_SETUP.md -双模式配置
• README.md -全套文件

libreoffice计算机mcp

完成LibreOffice Calc与HTTP代理和Python MCP服务器的集成。

特征：

• 11个MCP工具：读/写单元格、范围、公式；表单管理；搜索
• 基于UNO与LibreOffice的集成
• 在套接字模式下自动启动LibreOffice——无需手动配置
• 为LibreOffice捆绑的Python自动配置Windows
• 用于远程访问的可选Cloudflare隧道

快速入门（Windows）：

cd packages\libreoffice-calc-mcp
START_LIBREOFFICE_AND_PROXY.bat

文档：

• README.md -完整的设置指南

libreoffice计算mcp服务器

Python MCP服务器，配备11个LibreOffice Calc工具。

特征：

• 演示MCP服务器实现模式
• 用于单元格/范围操作、公式计算、表格管理的工具

______________________________________________________________________

OAuth提供者模式

代理支持 OAuth 2.0提供者模式 用于安全的远程访问。

快速入门： 看 docs/OAUTH_QUICKSTART.md --5分钟设置

完整指南： 看 docs/OAUTH_TEST_GUIDE.md --完成OAuth测试

使用OAuth测试Echo服务器：

cd packages/mcp-http-proxy
npx mcp-proxy --config examples/echo-oauth-test.config.js

支持的提供商： GitHub、谷歌、Auth0和任何OAuth 2.0提供商

______________________________________________________________________

项目结构

mcp-proxy-monorepo/
├── docs/                              # Cross-cutting documentation
│   ├── OAUTH_QUICKSTART.md            # 5-minute OAuth setup
│   └── OAUTH_TESTING_GUIDE.md         # Complete OAuth testing
├── packages/
│   ├── mcp-http-proxy/                # Generic proxy package
│   │   ├── QUICKSTART.md              # Hevy example setup
│   │   ├── DUAL_MODE_SETUP.md         # Dual-mode guide
│   │   └── examples/                  # Configuration examples
│   ├── libreoffice-calc-mcp/          # LibreOffice integration
│   └── libreoffice-calc-mcp-server/   # Python MCP server
├── BATCH_FILES.md                     # Batch script reference
├── START_HEVY_CONNECTOR_WITH_TUNNEL.bat
├── START_LIBREOFFICE_CONNECTOR_WITH_TUNNEL.bat
└── package.json                       # Monorepo root

______________________________________________________________________

配置

每个包裹都有自己的 .env.example 文件：

# For mcp-http-proxy:
cp packages/mcp-http-proxy/.env.example packages/mcp-http-proxy/.env

# For LibreOffice:
cp packages/libreoffice-calc-mcp/.env.example packages/libreoffice-calc-mcp/.env

常见环境变量：

• OAUTH_CLIENT_SECRET --生成方式 node -e "console.log(require('crypto').randomBytes(32).toString('base64'))"
• YOUR_MCP_SERVER_API_KEY --因MCP服务器而异

______________________________________________________________________

发展

工作区结构

此monorepo使用 npm工作区:

mcp-proxy-monorepo/
├── packages/
│   ├── mcp-http-proxy/          # Generic proxy (workspace package)
│   ├── libreoffice-calc-mcp/    # Depends on mcp-http-proxy
│   └── libreoffice-calc-mcp-server/  # Python package (not in npm workspace)

工作区命令：

npm install                           # Install all dependencies
npm run dev -w packages/mcp-http-proxy
npm start -w packages/libreoffice-calc-mcp
npm run clean -ws --if-present        # Run in all workspaces

添加新的MCP代理

1. 创建 packages/your-mcp-proxy/
2. 添加 package.json 取决于 mcp-http-proxy
3. 创建 mcp.config.js 使用您的MCP服务器配置
4. 添加 README.md 带有设置说明

示例 package.json:

{
  "name": "your-mcp-proxy",
  "version": "1.0.0",
  "type": "module",
  "scripts": {
    "start": "mcp-proxy"
  },
  "dependencies": {
    "mcp-http-proxy": "*"
  }
}

示例 mcp.config.js:

export default {
  mcp: {
    command: 'npx',
    args: ['-y', 'your-mcp-server'],
    env: {
      API_KEY: process.env.YOUR_API_KEY
    }
  },
  server: {
    port: 8080,
    host: '127.0.0.1'
  }
};

______________________________________________________________________

贡献

欢迎投稿！拜托：

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 提交拉取请求

______________________________________________________________________

许可证

麻省理工学院

______________________________________________________________________

相关

• MCP协议
• hevy mcp -Hevy运动跟踪器MCP服务器