What is Meta Api Mcp Server

The meta-api-mcp-server is a meta API Gateway server that facilitates the connection of various APIs to Large Language Models (LLMs) like Claude and GPT through the Model Context Protocol (MCP). It allows AI assistants to directly interact with APIs and access real-world data sources.

Use cases

Use cases include building AI-powered applications that require real-time data access from multiple APIs, creating custom integrations for AI assistants, and simplifying the management of API configurations in development environments.

How to use

To use the meta-api-mcp-server, install it globally via NPM or from the source code. You can run it as a command line tool, specifying configuration files or folders, or load configurations from remote URLs. It also supports integration with MCP clients like Cursor.

Key features

Key features include multi-API support, easy addition of APIs via JSON configuration files, automatic conversion of Postman Collections to MCP tools, comprehensive HTTP API support, various authentication methods, and the ability to load configurations from local files or remote URLs.

Where to use

The meta-api-mcp-server can be used in various fields such as software development, AI integration, and data management, where there is a need to connect APIs with AI models for enhanced functionality.

Meta API MCP Server

A meta API Gateway server that works with the Model Context Protocol (MCP). You can connect any API to LLMs (Claude, GPT, etc.) through MCP. This enables AI assistants to interact directly with APIs and access real-world data sources.

Features

• 🔄 Multi-API support: Manage multiple APIs through a single server
• 🛠️ Easily add APIs with JSON configuration files
• 📋 Automatically convert Postman Collections to MCP tools
• 🔌 Comprehensive support for HTTP APIs (GET, POST, PUT, DELETE, PATCH)
• 🔒 Various authentication methods (API Key, Bearer Token)
• 📁 Load configurations from local files or remote URLs
• 📑 Support for configuration file lists

API Editor Tool

A user-friendly editor tool has been developed to create or edit JSON configuration files:

MCP API Editor

Installation

Global Installation with NPM (Recommended)

npm install -g meta-api-mcp-server

Installation from Source Code

git clone https://github.com/savhascelik/meta-api-mcp-server.git
cd meta-api-mcp-server
npm install

Usage

As a Command Line Tool

# Load from default api-configs/ folder
meta-api-mcp-server

# Specify a configuration file (in the directory where you run the server, there should be a folder with this name and structured json in it)
meta-api-mcp-server path/to/config.json

# Load from a specific folder
meta-api-mcp-server path/to/configs/

# Load from a remote URL
meta-api-mcp-server https://example.com/api-config.json

# Load from a remote configuration list
meta-api-mcp-server https://example.com/config-list.json

# Load from a Postman Collection ( your filename must contain the word ‘postman’, I'll bind it to a variable when I have time )
meta-api-mcp-server path/to/My-API.postman_collection.json

Using with Cursor or Other MCP Clients

To connect to an MCP client like Cursor, configure your mcp.json file as follows:

{
  "mcpServers": {
    "myApiServer": {
      "command": "meta-api-mcp-server",
      "args": [],
      "env": {
        "MCP_CONFIG_SOURCE": "api-configs/flexweather-endpoints.json",
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

{
  "mcpServers": {
    "myApiServer": {
      "command": "meta-api-mcp-server",
      "args": [
        "server.js",
        "path/to/api-config.json"
      ],
      "env": {
        "EXAMPLE_API_KEY": "your-api-key-here"
      }
    }
  }
}

{
  "mcpServers": {
    "flexweather": {
      "command": "node",
      "args": [
        "server.js"
      ],
      "env": {
        "MCP_CONFIG_SOURCE": "api-configs/flexweather-endpoints.json"
      }
    }
  }
}

{
  "mcpServers": {
    "lemonsqueezy": {
      "command": "node",
      "args": [
        "server.js"
      ],
      "env": {
        "MCP_CONFIG_SOURCE": "api-configs/lemon-squeezy-api.json",
        "LEMON_SQUEEZY_API_KEY": ""
      }
    }
  }
}

Postman Collection Conversion

Using your existing Postman collections with Meta API MCP Server is now very easy! You can use hundreds of ready-made APIs without writing a single line of code.

1. Export your Postman collection (in v2.1.0 format)
2. Start Meta API MCP Server with the collection file:

meta-mcp my-collection.postman_collection.json

3. The server will automatically:

   • Analyze all endpoints
   • Detect the authentication method
   • Extract path/query parameters
   • Analyze request body structure
   • Create MCP tools

4. Add your API key to the .env file (the server will tell you which environment variable to use)

Supported Postman Collection Features

• ✅ Multi-level folder structure
• ✅ Bearer token authentication
• ✅ API Key authentication
• ✅ Path parameters
• ✅ Query parameters
• ✅ Headers
• ✅ JSON request body
• ✅ Postman variables (like {{api_url}})

API Editor Tool

A user-friendly editor tool has been developed to create or edit JSON configuration files:

MCP API Editor

With this web tool, you can:

• Create API configurations through a visual interface
• Edit existing JSON configurations
• Convert Postman collections to MCP-compatible configuration files
• Validate configuration files
• Export your configurations as JSON

Postman Collections: You can upload your existing Postman collections to the editor tool and automatically convert them to MCP-compatible configurations. This allows you to quickly use your existing collections instead of configuring APIs from scratch.

The editor makes it easy to manage tool names, parameters, and all other configuration options.

Project Structure

The codebase is organized in a modular way to facilitate maintenance and extension:

meta-api-mcp-server/
├── serve.js
├── api-configs/            # Default config directory
└── package.json

API Configuration File Format

You can manually configure APIs using the following JSON format:

{
  "apiId": "my-api",
  "handlerType": "httpApi",
  "baseUrl": "https://api.example.com",
  "authentication": {
    "type": "bearerToken",
    "envVariable": "MY_API_TOKEN"
  },
  "endpoints": [
    {
      "mcpOperationId": "getUsers",
      "description": "Get a list of users",
      "targetPath": "/users",
      "targetMethod": "GET",
      "parameters": [
        {
          "name": "page",
          "in": "query",
          "required": false,
          "type": "integer",
          "description": "Page number"
        }
      ]
    }
  ]
}

License

MIT