HTTP MCP Bridge

SaraMCP

你只是想用它吗？=> https://saramcp.com/

一个强大的模型上下文协议（MCP）服务器管理平台，用于构建、配置和部署基于HTTP的人工智能工具。

SaraMCP使您能够创建可重用的HTTP API工具工具包，通过灵活的参数绑定进行配置，并将其作为MCP服务器暴露出来，这些服务器可与Claude Desktop和其他MCP客户端无缝协作。

特点/特性

核心能力

• 可重复使用工具包 - 创建基于HTTP的工具集合（类似于Postman集合），以便在多个MCP服务器之间共享
• 灵活参数系统 - 配置具有三层解析能力的参数：

- 实例级别带有变量替换的固定值 - 服务器级别共享默认值和加密密钥 - 暴露的大语言模型（LLMs）在运行时提供的动态参数

• 类型安全 - 具有验证功能的强类型参数系统（字符串、数字、整数、布尔值、JSON、URL）
• 密钥管理 - 使用AES-256-GCM加密API密钥和敏感配置
• 热重载 - 更新工具配置而无需重启服务器
• OAuth 2.0 集成 - 三级访问控制（公开/组织/私有）
• MCP协议 - 完整实现JSON-RPC 2.0，支持HTTP和SSE传输方式

开发者体验

• Web 用户界面（或网页用户界面） - 完整的网页界面，用于管理服务器、工具包和工具实例
• 命令行界面（CLI）工具 - 用于自动化和脚本编写的命令行工具
• 执行跟踪 - 内置日志记录和调试功能
• 自动发现 - 标准 .well-known MCP服务器发现的端点
• Docker 支持 - 使用docker-compose实现生产就绪的容器化

快速入门

先决条件

• Rust 1.75+（用于从源代码构建）
• SQLite 3
• Docker & Docker Compose（用于容器化部署）

安装

选项1：Docker（推荐）

# Clone the repository
git clone https://github.com/yourusername/saramcp.git
cd saramcp

# Copy environment template
cp .env.example .env

# Edit .env and set your configuration
# Minimal required: DATABASE_URL, SESSION_SECRET, SARAMCP_MASTER_KEY

# Start the server
docker-compose up -d

服务器将在 http://localhost:8080

选项2：从源代码构建

# Clone the repository
git clone https://github.com/yourusername/saramcp.git
cd saramcp

# Create data directory
mkdir -p data

# Copy environment template
cp .env.example .env

# Run database migrations
sqlx migrate run

# Build and run
cargo build --release
./target/release/saramcp

初步步骤

1. 创建一个账户

- 导航至 http://localhost:8080/signup - 创建您的第一个用户帐户

1. 创建一个工具包

- 进入“工具包”并点击“创建新工具包” - 添加带有参数模板的HTTP工具，如 https://api.example.com/users/{{integer:user_id}}

1. 创建一个服务器

- 前往“服务器”并点击“创建新服务器” - 导入您的工具包 - 配置工具实例并绑定参数

1. 与Claude桌面版一起使用

- 复制您服务器的MCP端点： http://localhost:8080/s/{server-uuid} - 添加到Claude Desktop的MCP配置中 - 在对话中开始使用你的工具吧！

配置

环境变量

创建一个 .env 包含以下变量的文件：

# Database
DATABASE_URL=sqlite://data/saramcp.db

# Security (generate random 64-character strings)
SESSION_SECRET=your_64_character_random_string_here
SARAMCP_MASTER_KEY=your_base64_encoded_32_byte_key_here

# Server
HOST=127.0.0.1
PORT=8080
RUST_LOG=info

# Email (optional - for password reset)
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_USERNAME=noreply@example.com
SMTP_PASSWORD=your_smtp_password
SMTP_FROM_EMAIL=noreply@example.com
SMTP_FROM_NAME=SaraMCP
SMTP_ENCRYPTION=starttls

生成密钥

# Generate SESSION_SECRET
openssl rand -hex 32

# Generate SARAMCP_MASTER_KEY
openssl rand -base64 32

使用示例

示例1：货币转换器工具

工具定义：

Name: get_exchange_rate
URL: https://api.exchangerate-api.com/v4/latest/{{string:base_currency}}
Method: GET

工具实例配置：

Instance Name: convert_usd_to_eur
Parameters:
  - base_currency: "USD" (instance-level, fixed)

当克劳德打电话来时 convert_usd_to_eur它会自动获取美元汇率。

示例2：使用密钥的身份验证API

工具定义：

Name: create_issue
URL: https://api.github.com/repos/{{string:repo}}/issues
Method: POST
Headers:
  Authorization: Bearer {{string:github_token}}
Body: {"title": "{{string:title}}", "body": "{{string:description}}"}

服务器配置：

Server Globals (encrypted):
  - github_token: ghp_your_secret_token_here (secret)

工具实例：

Instance Name: create_project_issue
Parameters:
  - repo: "myorg/myproject" (instance-level)
  - github_token: (server-level, uses encrypted secret)
  - title: (exposed, LLM provides)
  - description: (exposed, LLM provides)

现在，克劳德只需提供标题和描述，就能创建 GitHub 问题！

建筑学

SaraMCP采用了一种简洁的三层架构：

┌─────────────────────────────────────┐
│  Web Handlers (Axum Routes)        │  ← HTTP endpoints
└──────────────┬──────────────────────┘
               │
               ▼
┌─────────────────────────────────────┐
│  Services (Business Logic)          │  ← Core functionality
│  - Parameter Resolution             │
│  - Secrets Management               │
│  - HTTP Execution                   │
│  - MCP Protocol                     │
└──────────────┬──────────────────────┘
               │
               ▼
┌─────────────────────────────────────┐
│  Models & Repositories              │  ← Data access
└─────────────────────────────────────┘

如需详细的架构文档，请参阅 CLAUDE.md（文件名或标记，可译为“克劳德.md”或保持原样，具体取决于上下文是否需要翻译文件名）。

发展

设置开发环境

# Install Rust toolchain
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Install sqlx-cli for database management
cargo install sqlx-cli --no-default-features --features sqlite

# Clone and setup
git clone https://github.com/yourusername/saramcp.git
cd saramcp
cp .env.example .env
mkdir -p data

# Run migrations
sqlx database create
sqlx migrate run

# Start development server
cargo run

运行测试

# Run all tests
cargo test

# Run tests with output
cargo test -- --nocapture

# Run specific test
cargo test test_parameter_resolution

# Run with coverage (requires tarpaulin)
cargo tarpaulin --out Html

代码质量

# Format code
cargo fmt

# Run linter
cargo clippy -- -D warnings

# Check without building
cargo check

项目结构

saramcp/
├── src/
│   ├── main.rs                 # Application entry point
│   ├── lib.rs                  # Library exports
│   ├── models/                 # Data models
│   ├── services/               # Business logic
│   │   ├── parameter_resolver.rs
│   │   ├── secrets_manager.rs
│   │   ├── http_executor.rs
│   │   └── instance_executor.rs
│   ├── mcp/                    # MCP protocol implementation
│   │   ├── service.rs          # MCP handler
│   │   ├── registry.rs         # Server lifecycle
│   │   └── handlers.rs         # HTTP endpoints
│   ├── handlers/               # Web request handlers
│   ├── middleware/             # Authentication & middleware
│   └── bin/
│       └── cli.rs             # CLI tools
├── migrations/                 # Database migrations
├── templates/                  # Askama HTML templates
├── static/                     # CSS, JS, images
├── tests/                      # Integration tests
├── Dockerfile
├── docker-compose.yml
└── CLAUDE.md                   # Detailed system design

API终端点

MCP协议端点

• POST /s/{uuid} - MCP JSON-RPC HTTP传输
• GET /s/{uuid}/sse - MCP 服务器发送事件传输
• GET /.well-known/mcp-servers - MCP服务器发现
• GET /.well-known/oauth-authorization-server - OAuth 元数据
• GET /.well-known/oauth-protected-resource/s/{uuid} - 每台服务器的OAuth元数据

网页界面

• / - 仪表盘
• /login - 认证
• /toolkits - 工具包管理
• /servers - 服务器管理
• /servers/{id}/instances - 工具实例配置

做出贡献

我们欢迎投稿！请参阅 CONTRIBUTING.md 翻译为中文是：“贡献指南.md” 或 “贡献说明文件.md”，具体翻译可能根据上下文有所调整，但基本意思是指一个关于如何向项目贡献代码或内容的指南文件 作为指导方针。

开发工作流程

1. 为仓库创建分支（或：克隆仓库）
2. 创建一个特性分支（git checkout -b feature/amazing-feature)
3. 在测试中进行更改
4. 确保所有测试通过（cargo test)
5. 运行代码质量检查（cargo clippy -- -D warnings && cargo fmt)
6. 提交您的更改（git commit -m 'Add amazing feature'）
7. 推送到分支（git push origin feature/amazing-feature)
8. 提交一个拉取请求

安全

报告漏洞

如果您发现安全漏洞，请发送邮件至security@yourdomain.com。请不要公开发布问题。

安全特性

• 密码哈希处理Argon2id，具备安全默认设置
• 会话管理使用SQLite存储的签名、加密会话
• 秘密加密AES-256-GCM用于API密钥和敏感数据
• 跨站请求伪造（CSRF）保护所有表单均采用基于令牌的CSRF（跨站请求伪造）保护
• OAuth 2.0行业标准授权，具备三级访问控制
• 输入验证类型安全的参数验证和清理

许可证

这个项目遵循MIT许可证授权——详见 许可证 文件中有详细信息。

致谢

• 构建于 阿克苏姆 网络框架
• 通过MCP协议支持 rmcp
• 受……的启发 邮递员 以及模型上下文协议规范

支持

• 文档： CLAUDE.md（文件名，可译为“克劳德.md”或保持原样，具体取决于上下文是否需要翻译文件名）
• 部署指南: \DEPLOYMENT_GUIDE.md\ 翻译为中文是：\部署指南.md\
• 问题：
• 讨论：

______________________________________________________________________

为AI代理生态系统倾注爱心打造