mcp_server_generator

mcp_server_generator

简介

mcp_server_generator 是一个开源库，可根据经过验证的架构，自动生成 Node.js、Python 或 Java 的完整 MCP 服务代码库。生成的服务包含模块化文件，可直接通过命令行运行，也可集成到 Claude Desktop。借助此工具，开发者可以专注于应用逻辑，而由生成器处理样板代码和最佳实践。

功能

• 多语言支持：支持生成 TypeScript（Node.js）、Python 和 Java 代码。
• 工具创建：生成服务所需的基本工具、资源、提示词和传输机制。
• 模块化代码库：生成结构清晰、易于浏览和扩展的模块化代码库。
• 开箱即用的服务：提供功能完备的服务配置，只需极少的配置。
• 兼容 Claude Desktop：确保生成的结构兼容 Claude Desktop 集成。
• 符合 SDK 规范的目录结构：遵循 SDK 规范的目录组织最佳实践。

安装说明

Node.js（TypeScript）

若要在 TypeScript 项目中安装 mcp_server_generator，请使用 npm：

npm install mcp_server_generator --save-dev

Python

对于 Python 项目，可使用 pip 安装此库：

pip install mcp-server-generator

Java

在 Java 项目中，如果使用 Maven，请将以下依赖项添加到 pom.xml：

<dependency>
    <groupId>com.github.yourusername</groupId>
    <artifactId>mcp_server_generator</artifactId>
    <version>1.0.0</version>
</dependency>

如果依赖托管在自定义 Maven 服务上，请确保在 pom.xml 中配置了正确的仓库。

使用示例

Node.js（TypeScript）

import { generateServer } from 'mcp_server_generator';

const schema = {
    // Your validated schema here
};

generateServer(schema, 'node', './output')
    .then(() => console.log('Server generated successfully!'))
    .catch(err => console.error('Error generating server:', err));

Python

from mcp_server_generator import generate_server

schema = {
    # Your validated schema here
}

generate_server(schema, 'python', './output')
print("Server generated successfully!")

Java

import com.github.yourusername.mcp_server_generator.McpServerGenerator;

public class Main {
    public static void main(String[] args) {
        try {
            Map<String, Object> schema = new HashMap<>();
            // Populate your validated schema here
            
            McpServerGenerator.generateServer(schema, "java", "./output");
            System.out.println("Server generated successfully!");
        } catch (Exception e) {
            System.err.println("Error generating server: " + e.getMessage());
        }
    }
}

API 文档

generateServer 函数

Node.js/TypeScript

generateServer(schema: object, language: 'node' | 'python' | 'java', outputDir: string): Promise<void>

• schema：用于生成服务的经过验证的架构。
• language：目标编程语言（node、python 或 java）。
• outputDir：生成文件的存放目录。

Python

generate_server(schema: dict, language: str, output_dir: str) -> None

• schema：表示经过验证的架构的字典。
• language：目标编程语言（node、python 或 java）。
• output_dir：指定生成文件目录的字符串。

Java

public static void generateServer(Map<String, Object> schema, String language, String outputDir) throws Exception

• schema：包含经过验证的架构的映射。
• language：目标编程语言（node、python 或 java）。
• outputDir：生成文件的存放目录。

许可证

本项目采用 MIT License 授权。详情请参阅 LICENSE 文件。

---

欢迎为此库贡献代码，让它变得更好！

⚠️ 开发状态

此库目前仍处于早期开发阶段。部分测试可能会因以下问题而失败：

欢迎提交贡献来修复这些问题！如果您有解决方案，请提交 pull request。