# Api Mcp Server

> MCP server from bluechenchenchen/api-mcp-server.

- **Type:** MCP server
- **Install:** `agentstack add mcp-bluechenchenchen-api-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [bluechenchenchen](https://agentstack.voostack.com/s/bluechenchenchen)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [bluechenchenchen](https://github.com/bluechenchenchen)
- **Source:** https://github.com/bluechenchenchen/api-mcp-server

## Install

```sh
agentstack add mcp-bluechenchenchen-api-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# api-mcp-server

English | [简体中文](README.zh-CN.md)

  API MCP Server
  A Swagger/OpenAPI Documentation Retrieval Tool Based on MCP (Model Context Protocol)
  

This is a Swagger/OpenAPI documentation retrieval tool based on MCP (Model Context Protocol). It can fetch and parse Swagger/OpenAPI documentation from specified URLs, intelligently clean and optimize the documentation to reduce token consumption, and provide it to intelligent IDEs (such as Cursor) in a standardized format. The tool supports multiple transport methods, making it easy for IDEs to retrieve and understand API documentation, enabling intelligent features such as interface suggestions, auto-completion, and code generation.

## ✨ Features

- Intelligent Document Processing

  - Fetch Swagger/OpenAPI documentation from remote URLs
  - Support for Swagger 2.0 and OpenAPI 3.x formats
  - Intelligent cleaning and optimization of document structure to reduce token consumption
  - Extract key API information including endpoints, parameters, response formats, etc.

- IDE-Friendly Design

  - Standardized API description format
  - Automatic generation of example requests and responses
  - Intelligent parameter hints and type inference
  - Support for code auto-completion and generation

- Multiple Transport Methods
  - stdio: Standard input/output mode for command-line tools
  - http: HTTP server mode with RESTful interface support
  - sse: Server-Sent Events mode for real-time communication

## Getting Started

### MacOS / Linux

```json
{
  "mcpServers": {
    "api-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "api-mcp-server",
        "--transport",
        "stdio",
        "--doc-url",
        "xxx"
      ]
    }
  }
}
```

### Windows

```json
{
  "mcpServers": {
    "api-mcp-server": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "api-mcp-server",
        "--transport",
        "stdio",
        "--doc-url",
        "xxx"
      ]
    }
  }
}
```

### Command Line Arguments

- `--transport `: Choose transport method (default: stdio)
- `--port `: HTTP/SSE server port (default: 3000)
- `--doc-url `: Swagger/OpenAPI documentation URL (required)

### Usage Examples

#### 1. Basic Usage

```bash
# Using stdio mode (default)
npx -y api-mcp-server --doc-url https://api.example.com/swagger.json

# Using HTTP mode
npx -y api-mcp-server --transport http --doc-url https://api.example.com/swagger.json

# Using SSE mode with custom port
npx -y api-mcp-server --transport sse --port 3001 --doc-url https://api.example.com/swagger.json
```

## 💻 Development

```bash
# Clone the repository
git clone https://github.com/bluechenchenchen/api-mcp-server.git

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build
pnpm build
```

## Debugging

Use @modelcontextprotocol/inspector

```bash
npx @modelcontextprotocol/inspector
```

## Run Example

```bash
pnpm example
```

## 📋 Requirements

- Node.js >= 16.0.0
- npm >= 6.0.0 or pnpm >= 6.0.0

## 📄 License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [bluechenchenchen](https://github.com/bluechenchenchen)
- **Source:** [bluechenchenchen/api-mcp-server](https://github.com/bluechenchenchen/api-mcp-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-bluechenchenchen-api-mcp-server
- Seller: https://agentstack.voostack.com/s/bluechenchenchen
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.