MCP Api Server

🚀 MCP API Server

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

✨ Features

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

📚 Documentation

This repository contains a detailed step-by-step guide for building an MCP server:

• BUILD_MCP_SERVER_GUIDE.md: A detailed tutorial for creating a Model Context Protocol server from scratch, explaining core concepts, implementation details, and best practices.

The guide covers:

• Project setup and structure
• Fundamental principles of the MCP architecture
• Construction of core components
• Authentication implementation
• Creation of custom tools
• Testing and integration with VS Code
• Suggestions for advanced features

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

📦 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 Examples

Basic Usage

You can directly run the server:

# Development mode
npm run dev

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

Advanced Usage

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

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

{
  "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 of the project.
4. Restart VS Code or reload the window.
5. Compatible AI extensions will be able to use the MCP server.

Troubleshooting

• If the MCP server fails to connect, check the error messages in the VS Code developer console.
• Verify that the path in mcp.json is correct and accessible.
• Ensure that the server is successfully built using npm run build.

💻 MCP Integration

This MCP server exposes the following tools:

1. auth

Manage authentication tokens for secure API access.

Parameters:

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

2. vehicle_api

Make API calls to external services to retrieve vehicle data.

No parameters are 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