返回 MCP 目录
public公开dns本地运行

mcp-server-magic

MCP Server Magic是一个帮助用户轻松生成Model Context Protocol服务器的工具,支持生成TypeScript、Python和Go语言的服务器,提供直接实现和代理两种模式,并支持多种部署方式和认证配置。

article

README

🚀 MCP Server Magic项目

MCP Server Magic可自动生成多语言的MCP服务器,支持多种身份验证和部署环境。新推出的API代理模式,能轻松实现现有API的代理功能,为开发带来极大便利。

🚀 快速开始

该项目可直接访问 项目链接 并进行操作。若想在本地开发,需安装 Node.js 和 npm(使用 nvm 安装),然后按以下步骤操作:

# 步骤1:使用项目的Git URL克隆仓库。
git clone <YOUR_GIT_URL>

# 步骤2:进入项目目录。
cd <YOUR_PROJECT_NAME>

# 步骤3:安装必要的依赖项。
npm i

# 步骤4:启动带有自动重载和即时预览的开发服务器。
npm run dev

✨ 主要特性

  • 自动生成 TypeScript、Python 和 Go 语言的 MCP 服务器。
  • 支持配置身份验证,包括 API 密钥、Bearer 令牌、基本认证。
  • 可定义资源和工具。
  • 能部署到多种环境,如 AWS、GCP、Azure、自托管。
  • 新功能:API 代理模式 - 创建能代理到现有 API 的 MCP 服务器。

🔧 服务器运行模式

MCP Server Magic 支持两种服务器生成模式:

直接实现模式

这是默认模式,MCP Server Magic 会为您的 MCP 服务器生成一个完整的独立实现。该服务器处理所有逻辑和数据处理。

代理模式

代理模式允许您创建一个 MCP 服务器,作为 MCP 客户端(如 Claude)与现有 API 之间的中间件。MCP 服务器将 MCP 格式的请求转换为标准 API 调用,并将响应从标准格式转回 MCP 格式。

  • 代理模式功能
    • 连接到任何现有的 REST API。
    • 自动转换 MCP 和标准格式之间的转换。
    • 可选缓存以提高性能。
    • 可选速率限制以保护目标 API。
    • 支持客户端和目标 API 的双重身份验证。
    • 完全符合模型上下文协议标准。

💻 使用示例

测试

该项目包含全面的测试,确保生成服务器的质量:

# 运行基本MCP服务器测试
npm test

# 运行包括Go服务器生成在内的完整MCP测试
npm run test:mcp

# 运行代理模式测试
npm run test:proxy

📚 详细文档

如何编辑代码?

有几种方法可以编辑您的应用程序。

  • 使用 Lovable 只需访问 Lovable 项目 并开始提示。通过 Lovable 做出的更改会自动提交到此仓库。
  • 使用您首选的 IDE 如果您希望在本地使用自己的 IDE 工作,可以克隆此仓库并将更改推送到仓库。推送的更改也会反映在 Lovable 中。

🔧 技术细节

该项目使用以下技术构建:

  • Vite
  • TypeScript
  • React
  • shadcn-ui
  • Tailwind CSS
  • 模型上下文协议 SDK
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端