AI导哈

REST API转换工具

MCP Workspace是一个可视化配置平台，可将现有的RESTful API转换为标准化的Model Context Protocol（MCP）服务，无需编码即可实现API与AI助手的交互。

  • by larryteal
  • TypeScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 larryteal/mcp-workspace

使用说明

MCP工作区

Convert any REST API into a Model Context Protocol (MCP) service — no coding required.

Design Philosophy • Security • Try It Out • Quick Start • Deployment

什么是MCP工作区？

MCP工作区 是一个可视化配置平台，它将现有的RESTful API转换为标准化的 模型上下文协议（MCP） 服务。它充当您的API和Claude等人工智能助手之间的桥梁，使它们能够通过统一的协议与您的服务进行交互。

为什么选择MCP工作区？

  • 无需代码：通过直观的web界面配置API到MPCP的映射
  • 即时集成：您的REST API将作为MCP工具立即可用
  • 目视检测：使用内置验证在部署前测试API配置
  • 灵活部署：只需单击一下即可自行托管或部署到Cloudflare Workers

设计理念

本地优先、个人优先、易用性优先

MCP工作区的设计考虑到了简单性：

  • 无需登录：立即开始使用，无需创建帐户
  • 自托管：部署在您的本地计算机或Cloudflare Workers上——您拥有自己的数据
  • 个人AI工具包：构建自己的MCP封装API集合作为AI辅助工具

弥合MCP差距

许多公司提供了出色的API，但尚未在官方MCP支持下拥抱人工智能时代。MCP工作区的功能如下：

  • 权宜之计：在等待API供应商的官方MCP服务时使用
  • 参考实施：向公司展示如何在不构建专用MCP基础设施的情况下，将现有API作为MCP服务快速公开
  • 统一的方法：公司不需要维护单独的MCP服务和REST API——打包一次，同时服务两者

安全通知

该项目完全通过Vibe Coding构建，没有经过严格的安全测试。

重要安全注意事项

  1. 不要共享浏览器URL

    • 任何拥有您的工作区URL的人都有完全的管理权限
    • 浏览器URL包含您的工作区ID，该ID授予编辑权限

  2. MCP URL可以安全共享

    • 生成的MCP端点URL使用哈希工作区ID
    • 其他人无法从MCP URL对您的管理URL进行反向工程

  3. 敏感凭据

    • 如果您的MCP配置包含API密钥或机密， 仅在本地部署
    • 避免在云部署的实例中存储敏感凭据

试试看

新加入MCP工作区？尝试包装 GitHub趋势API 作为您的第一个MCP服务：

👉 github/larryteal/ithubtrending

该项目为GitHub趋势数据提供了JSON API，并已被验证可与MCP Workspace一起使用。这是在包装自己的API之前练习和熟悉平台的好方法。

特性

Visual API配置

配置HTTP方法、标头、查询参数、请求正文和Cookie

动态输入模式

使用JSON模式定义输入参数。模板变量({{varName}})在运行时自动替换。

实时API测试

在将API保存为MCP服务之前，验证是否可以成功调用该API。 这是必要的，因为一些API会阻止来自云IP的访问。在验证过程中，请确保使用具体值而不是模板变量。

MCP就绪输出

生成与Claude Code和其他MCP客户端兼容的MCP服务器配置。

快速开始

先决条件

  • Node.js
  • pnpm

本地开发

# Clone the repository
git clone https://github.com/larryteal/mcp-workspace.git
cd mcp-workspace

# Install dependencies
cd frontend && pnpm install
cd ../backend && pnpm install

# Initialize the database
cd backend && npx wrangler d1 migrations apply DB --local

# Start development servers (in separate terminals)
cd frontend && pnpm dev    # Frontend on http://localhost:5173
cd backend && pnpm dev     # Backend on http://localhost:2300

用法

1.创建MCP服务

点击 "+" 侧边栏中的按钮，用于创建新的MCP服务。给它一个名字和描述。

2.添加工具

每个工具都映射到一个REST API端点。配置：

  • 名字：AI助手使用的工具标识符
  • 描述：帮助AI了解何时使用此工具
  • HTTP方法：GET、POST、PUT、DELETE等。
  • 统一资源定位符：API终结点
  • 参数：查询参数、标头、Cookie和请求正文（支持｛｛variables｝｝。模板变量必须定义为输入架构中的属性。）

3.定义输入模式

指定您的工具使用JSON模式接受的输入参数， MCP客户端在调用工具时将提供输入模式中定义的参数。

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "since": {
      "type": "string",
      "enum": ["daily", "weekly", "monthly"],
      "description": "Time window for the query"
    }
  },
  "required": ["since"],
  "additionalProperties": false
}

4.测试您的配置

使用 测试 按钮来验证API配置是否正常工作。

5.获取MCP配置

复制生成的MCP配置并将其添加到MCP客户端配置文件中：

{
  "mcpServers": {
    "my-service": {
      "type": "http",
      "url": "https://{domain}/workspace/{hash}/mcp/{serviceId}"
    }
  }
}

部署

Cloudflare Workers（推荐）

前端和后端都是为Cloudflare Workers部署而设计的：


# Deploy backend
# Replace {env} with staging or production (Check the scripts defined in package.json)
# Replace database_id in wrangler.jsonc with the actual D1 database ID
cd backend && npx wrangler d1 migrations apply DB --remote --env {env} && pnpm run deploy:{env}

# Deploy frontend
cd frontend && pnpm run deploy:{env}

环境变量

创建 .env.production 在前端目录中：

VITE_MCP_API_BASE_URL=https://{domain}

技术栈

前端

  • React 19与TypeScript
  • 蚂蚁设计6（暗模式）
  • 维特
  • Cloudflare页面

后端

  • Hono（Web框架）
  • Cloudflare Workers+D1（SQLite）
  • MCP-SDK(@modelcontextprotocol/sdk, agents/mcp)
  • Zod（验证）

项目结构

mcp-workspace/
├── frontend/          # React management interface
│   ├── src/
│   │   ├── components/   # UI components
│   │   ├── context/      # React contexts
│   │   ├── pages/        # Page components
│   │   └── services/     # API services
│   └── index.html
├── backend/           # Hono API server
│   ├── src/
│   │   ├── routes/       # API routes
│   │   └── utils/        # Utilities
│   └── migrations/       # D1 migrations
└── design/            # UI design files

许可证

MIT许可证

Built with the Model Context Protocol

相关 MCP