mcp-api-server

MCP API Server

An API-focused Model Context Protocol (MCP) server that provides authentication and API call capabilities. This server allows secure API calls through MCP tools, with authentication management and response handling.

Architecture

Features

• Authentication management with token-based security
• Make authenticated API calls to external services
• Secure token management with authentication state tracking
• Well-typed responses using the MCP protocol structure
• Response formatting for different content types (JSON, text)

Documentation

This repository includes a comprehensive step-by-step guide for building MCP servers:

• : A detailed tutorial that walks through the process of creating a Model Context Protocol server from scratch, with explanations of core concepts, implementation details, and best practices.

The guide covers:

• Project setup and structure
• MCP architecture fundamentals
• Building core components
• Authentication implementation
• Creating custom tools
• Testing and VS Code integration
• Advanced feature suggestions

Both beginners and experienced developers will find valuable information in this guide for implementing their own MCP servers.

Prerequisites

• Node.js 16+
• npm

Installation

# Clone the repository
git clone https://github.com/ranjanmadhu/mcp-api-server.git
cd mcp-api-server

# Install dependencies
npm install

Usage

You can run the server directly:

# Development mode
npm run dev

# Or build and run in production
npm run build
npm start

VS Code Integration

This server can be integrated with VS Code through the Model Context Protocol:

1. Create a .vscode folder in your project (if it doesn't exist)
2. Add a mcp.json file with the following configuration:

{
  "servers": {
    "api-mcp-server": {
      "type": "stdio",
      "command": "sh",
      "args": [
        "-c",
        "cd /path/to/mcp-api-server && npm run build && npm run start"
      ]
    }
  }
}

3. Replace /path/to/mcp-api-server with the absolute path to your project
4. Restart VS Code or reload the window
5. The MCP server will be available to compatible AI extensions

Troubleshooting

• If the MCP server isn't connecting, check the VS Code Developer Console for errors
• Verify the path in mcp.json is correct and accessible
• Ensure the server builds successfully with npm run build

MCP Integration

This MCP server exposes the following tools:

1. auth

Manages authentication tokens for secure API access.

Parameters:

• action: The authentication action to perform (set, check, or clear)
• token: The authentication token (required for set action)

2. vehicle_api

Makes an API call to retrieve vehicle data from an external API.

No parameters required.

Data Structure

API call responses are formatted according to the MCP protocol:

interface ToolResponse {
  content: Array<{
    type: "text" | "image" | "audio" | "resource";
    text?: string;
    data?: string;
    mimeType?: string;
    resource?: {
      text?: string;
      uri: string;
      blob?: string;
      mimeType?: string;
    };
  }>;
  _meta?: Record<string, unknown>;
  isError?: boolean;
}

License

MIT