OpenAPI转MCP服务器生成器

# Clone repository
git clone https://github.com/YOUR_USERNAME/Magic-MCP.git
cd Magic-MCP

# Install dependencies
npm install

# Build all packages
npm run build

GOOGLE_CLOUD_PROJECT=your-project-id
GOOGLE_CLOUD_LOCATION=us-central1
VERTEX_AI_MODEL=gemini-2.0-flash-exp
VERTEX_AI_LOCATION=us-central1
LOG_LEVEL=info

gcloud config configurations create magic-mcp
gcloud auth login
gcloud config set project your-project-id
gcloud services enable aiplatform.googleapis.com
gcloud auth application-default login

# Generate from OpenAPI spec with tests
node packages/cli/dist/cli.js generate \
  examples/github-repos-api.yaml \
  --output my-mcp-server

# Build, test, and run the generated server
cd my-mcp-server
npm install
npm run build
npm test        # Run 26 generated tests!
npm start

// Component name preserved!
export interface Repository {
  /** Unique identifier of the repository */
  id: number;
  /** The name of the repository */
  name: string;
  /** Simple User */
  owner: { login: string; id: number };
  // ... 20 properties with JSDoc
}

// Array response uses the component type
export type ListForAuthenticatedUserResponse = Repository[];

// Duplicate responses use type aliases (no duplication!)
export type CreateForAuthenticatedUserResponse = Repository;
export type GetResponse = Repository;
export type UpdateResponse = Repository;

// Zod schema for nested type (for validation)
export const RepositorySchema = z.object({
  id: z.number().describe('Unique identifier'),
  name: z.string().describe('The name of the repository'),
  owner: z.object({ login: z.string(), id: z.number() }),
  // ... full validation
});

// Zod validation with enum and array support
const ReposListSchema = z.object({
  visibility: z.enum(['all', 'public', 'private']).optional(),
  tags: z.array(z.string()).optional(),  // Proper array types!
  ids: z.array(z.number()).optional(),
});

// Fully-typed client method
async reposListForAuthenticatedUser(
  params: z.infer<typeof ReposListSchema>
): Promise<ListForAuthenticatedUserResponse> {
  // Implementation with type safety
}

// Generated tests (26 tests for GitHub API)
describe('repos_list_for_authenticated_user', () => {
  it('should validate input schema correctly', () => { ... });
  it('should build query parameters correctly', () => { ... });
  // ... 24 more tests
});

packages/
├── cli/              # Command-line interface (Commander.js)
├── parser/           # OpenAPI parser (@apidevtools/swagger-parser)
├── generator/        # Code generator (Handlebars + Vertex AI)
├── security/         # Security scanner (10+ categories)
└── shared/           # Shared types and utilities

OpenAPI Spec → Parser → AI Analysis → MCP Spec → Template → Generated Code → Security Scan

npm run build
node packages/cli/dist/cli.js generate examples/github-repos-api.yaml --output test
cd test && npm run build  # Should compile without errors

# Generate MCP server
node packages/cli/dist/cli.js generate <spec-path> [options]

Options:
  --output <dir>     Output directory (default: ./output)
  --name <name>      Custom MCP server name
  --no-tests         Skip test generation
  --project <id>     Google Cloud project ID
  --location <loc>   Vertex AI location (default: us-central1)

# Examples
node packages/cli/dist/cli.js generate https://api.stripe.com/openapi.yaml
node packages/cli/dist/cli.js generate examples/github-repos-api.yaml --output my-server
node packages/cli/dist/cli.js generate spec.json --no-tests --name my-api

# 1. Code Generation Quality
npm run build
node packages/cli/dist/cli.js generate examples/github-repos-api.yaml --output test
cd test && npm run build  # Should succeed

# 2. Component Name Preservation
grep "export interface Repository" test/src/index.ts  # Should find

# 3. Type Safety
grep -c "Promise<unknown>" test/src/index.ts  # Should be minimal

# 4. Security Score
# Check CLI output for "Security scan passed (score: XX/100)"