Introduction

Welcome to forge-mcptools - Create MCP tools for databases, REST APIs, and more

What is forge-mcptools?

forge-mcptools is a comprehensive platform for creating, deploying, and managing Model Context Protocol (MCP) connectors for databases and APIs. It provides a complete toolkit for building custom connectors that integrate with various data sources, enabling seamless access to your data through a unified interface.

Key Features

Database Connectors

Build connectors for PostgreSQL, MSSQL, MySQL, and more with built-in connection pooling and async operations.

Dashboard Management

Manage connectors, servers, and tools through an intuitive web dashboard.

Docker Support

Deploy connectors using Docker with hot-reload support for development.

API Integration

RESTful API for programmatic access to all platform features.

Architecture

forge-mcptools consists of three main components:

1. Backend (FastAPI): Core API server managing connectors, servers, and authentication
2. Frontend (React): Web dashboard for visual management
3. Connectors: Standalone services that interface with specific data sources

Quick Start

1. Prerequisites

   Install Python 3.12+, Docker, UV package manager, and Node.js

   View full prerequisites →

2. Local Setup

   Clone the repository and set up your development environment

   git clone https://github.com/yourusername/forge-mcptools.git
   cd forge-mcptools
   

   Complete setup guide →

3. Create Your First Connector

   Follow our step-by-step guide to create a custom database connector

   Create a connector →

4. Deploy

   Deploy your connectors using Docker Compose

   Deployment guide →

Available Connectors

PostgreSQL Connector

Full-featured PostgreSQL connector with async operations, connection pooling, and schema introspection.

Features:

• AsyncPG-based connection pooling
• Table listing and schema inspection
• Parameterized query execution
• Transaction support

Learn more →

MSSQL/Azure SQL Connector

Microsoft SQL Server and Azure SQL Database connector with ODBC Driver 18 support.

Features:

• Azure SQL authentication
• Connection encryption
• Async operations with aioodbc
• Full schema introspection

Learn more →

Use Cases

Multi-Tenant Applications

Create isolated database connections for each tenant with dynamic connector instances.

Data Integration

Integrate multiple data sources into a unified access layer.

API Gateway

Build a centralized gateway for database access with authentication and monitoring.

Development Tools

Provide developers with easy access to database tools and query execution.

Community and Support

Get Help

Found a bug or have a question? Open an issue on GitHub

Next Steps

Understanding the Architecture

Learn how forge-mcptools components work together

Set Up Your Environment

Get your development environment ready

Build a Connector

Create your first database connector

Deploy to Production

Deploy your connectors using Docker