Api Wrapper MCP

🚀 API Wrapper MCP Server

A generic API wrapper server for the Model Context Protocol (MCP). It allows you to easily wrap REST APIs into MCP tools that can be accessed by Claude and other MCP clients.

🚀 Quick Start

✨ Features

• Easily configure multiple API endpoints using a YAML configuration file.
• Support for GET and POST requests.
• Parameter validation and default values.
• Authentication via environment variables.
• Customizable API call timeout.

📦 Installation

1. Create a YAML configuration file to define your API endpoints (see example-config.yaml).
2. Set any required API tokens as environment variables.
3. Run the server with the configuration file:

# Build the server
go build -o api_wrapper

# Run with the configuration file
./api_wrapper my-apis.yaml

💻 Usage Examples

Basic Usage

The configuration file uses the YAML format with the following structure:

# Server information
server:
  name: "API Gateway MCP"
  description: "A generic API gateway that wraps REST APIs into MCP tools"
  version: "1.0.0"

# Authentication
auth:
  token_env_var: "API_GATEWAY_TOKEN"  # API token in the environment variable

# Tool definition
tools:
  - name: "tool-name"
    description: "Tool description"
    endpoint: "https://api.example.com/endpoint"
    method: "POST"  # or "GET"
    timeout: 30  # in seconds
    template: |
      {
        "param1": "{{variable1}}",
        "param2": {{variable2}}
      }
    # For GET requests, use query_params
    query_params:
      param1: "{{variable1}}"
      param2: "{{variable2}}"
    parameters:
      variable1:
        type: "string"
        description: "Description of variable 1"
        required: true
      variable2:
        type: "number"
        description: "Description of variable 2"
        default: 10

Advanced Usage

To integrate with Claude Desktop, add the following to claude_desktop_config.json:

{
  "mcpServers": {
    "api-wrapper": {
      "command": "path/to/api_wrapper",
      "args": ["path/to/your-config.yaml"],
      "env": {
        "API_GATEWAY_TOKEN": "your-api-token"
      }
    }
  }
}

📚 Documentation

Check example-config.yaml for an example of API configuration.

🔧 Technical Details

• Set the main authentication token using the field specified in the environment variable: auth.token_env_var.
• You can also reference other environment variables in the template using the {{env:VARIABLE_NAME}} syntax.