MCP Toolkit

MCP Toolkit

A comprehensive collection of production-ready Model Context Protocol (MCP) servers for common tools and services.

Features

• PostgreSQL Server - Query, insert, update, and manage PostgreSQL databases
• SQLite Server - Lightweight SQLite database operations with full SQL support
• Redis Server - Key-value operations, pub/sub, and data structure manipulation
• File System Server - Secure file operations with sandboxing and access controls
• GitHub API Server - Repository management, issues, PRs, and more via GitHub API

Installation

# Install from PyPI
pip install mcp-toolkit

# Or install specific servers only
pip install mcp-toolkit[postgres]
pip install mcp-toolkit[sqlite]
pip install mcp-toolkit[redis]
pip install mcp-toolkit[filesystem]
pip install mcp-toolkit[github]

# Install all servers
pip install mcp-toolkit[all]

Quick Start

PostgreSQL

from mcp_toolkit.servers.postgres import PostgreSQLServer

server = PostgreSQLServer(
    connection_string="postgresql://user:pass@localhost:5432/mydb"
)
server.run()

SQLite

from mcp_toolkit.servers.sqlite import SQLiteServer

server = SQLiteServer(database_path="./data.db")
server.run()

Redis

from mcp_toolkit.servers.redis import RedisServer

server = RedisServer(redis_url="redis://localhost:6379/0")
server.run()

File System

from mcp_toolkit.servers.filesystem import FilesystemServer

server = FilesystemServer(
    root_dir="/path/to/workspace",
    read_only=False
)
server.run()

GitHub API

from mcp_toolkit.servers.github import GitHubServer

server = GitHubServer(
    github_token="ghp_..."
)
server.run()

CLI Usage

# Run PostgreSQL server
mcp-toolkit postgres --connection-string "postgresql://localhost/mydb"

# Run SQLite server
mcp-toolkit sqlite --database ./data.db

# Run Redis server
mcp-toolkit redis --url redis://localhost:6379

# Run Filesystem server
mcp-toolkit filesystem --root ./workspace

# Run GitHub server
mcp-toolkit github --token $GITHUB_TOKEN

Configuration

Environment Variables

# PostgreSQL
POSTGRES_CONNECTION_STRING=postgresql://user:pass@localhost/db

# Redis
REDIS_URL=redis://localhost:6379/0

# GitHub
GITHUB_TOKEN=ghp_xxxxxxxxxxxx

Claude Desktop Configuration

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "postgres": {
      "command": "mcp-toolkit",
      "args": ["postgres", "--connection-string", "postgresql://localhost/mydb"]
    },
    "redis": {
      "command": "mcp-toolkit",
      "args": ["redis", "--url", "redis://localhost:6379"]
    }
  }
}

API Reference

PostgreSQL Server

SQLite Server

Redis Server

Filesystem Server

GitHub Server

Development

# Clone the repository
git clone https://github.com/exycfs/mcp-toolkit.git
cd mcp-toolkit

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run linters
ruff check .
mypy src/

# Format code
ruff format .

Contributing

Contributions are welcome! Please read our Contributing Guidelines before submitting a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Built on the Model Context Protocol specification
• Inspired by the MCP ecosystem and community

Support

• GitHub Issues
• Discussions