Company API MCP Server Template

A template for creating Model Context Protocol (MCP) servers that integrate with your company's API using FastMCP.

Overview

This template provides a starting point for building MCP servers that can interact with your company's REST API. It includes:

Authentication handling (Bearer token)
Error handling and logging
Example tools for common API operations
Environment variable configuration
Proper async/await patterns

Setup

Clone this repository
Install dependencies:
pip install -e .
Set environment variables:
export API_BASE_URL="https://your-api.example.com" export API_KEY="your-api-key-here"

Configuration

The server can be configured using environment variables:

API_BASE_URL: Base URL of your company's API
API_KEY: API key for authentication

Usage

Running the server

python server.py

Available Tools

The template includes two example tools:

get_user_info(user_id): Retrieve user information by ID
search_items(query, limit): Search for items with optional limit

Customization

To adapt this template for your API:

Update the API_BASE_URL and authentication method in server.py
Modify the existing tools or add new ones based on your API endpoints
Update the response formatting to match your API's data structure
Add any additional error handling specific to your API

Example Tools Implementation

@mcp.tool()
async def your_custom_tool(param: str) -> str:
    """Description of what your tool does.
    
    Args:
        param: Description of the parameter
    """
    data = await make_api_request(f"your-endpoint/{param}")
    
    if not data or "error" in data:
        return "Error message"
    
    # Format and return your data
    return formatted_response

MCP Integration

To use this server with an MCP client, add it to your MCP configuration:

{
  "mcpServers": {
    "company-api": {
      "command": "python",
      "args": ["/path/to/server.py"],
      "env": {
        "API_BASE_URL": "https://your-api.example.com",
        "API_KEY": "your-api-key"
      }
    }
  }
}

Development

Project Structure

.
├── server.py           # Main MCP server implementation
├── main.py            # Simple CLI entry point
├── pyproject.toml     # Project configuration
├── README.md          # This file
└── .gitignore         # Git ignore rules

Adding New Tools

Define your tool function with the @mcp.tool() decorator
Use make_api_request() to call your API
Handle errors appropriately
Format the response for the user

License

[Add your license here]

Contributing

[Add contribution guidelines here]

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A template for building Model Context Protocol servers that connect to company REST APIs using FastMCP, providing authentication handling, error management, and example tools for common API operations.

Related MCP Servers

MCP Server Starter
GreatAuk
A
security
A
license
A
quality
A TypeScript-based template for building Model Context Protocol servers, featuring fast testing, automated version management, and a clean structure for MCP tool implementations.
Last updated -
1
521
4
TypeScript
MIT License
MCP REST API Server
vinaykp
-
security
F
license
-
quality
A server implementation of the Model Context Protocol (MCP) that provides REST API endpoints for managing and interacting with MCP resources.
Last updated -
Python
FastAPI MCP Application
christian-felipe9
-
security
A
license
-
quality
A REST API built with FastAPI that exposes endpoints via Model Context Protocol (MCP), allowing clients to interact with CRUD operations through MCP interfaces.
Last updated -
Python
MIT License
OpenAPI MCP Server
oneWalker
-
security
A
license
-
quality
A server that implements the Model Context Protocol (MCP) with StreamableHTTP transport, enabling standardized interaction with model services through a RESTful API interface.
Last updated -
155
1
JavaScript
MIT License

View all related MCP servers

Company API MCP Server Template