Skip to main content
Glama
fzs356113-oss

MCP Server Toolkit

๐Ÿ”Œ MCP Server Toolkit

The fastest way to connect AI agents to the real world.

Python 3.10+ License: MIT MCP Compatible Stars Forks

A production-ready Model Context Protocol server toolkit that gives your AI agents superpowers.

Quick Start ยท Features ยท Architecture ยท Documentation


๐ŸŽฏ Why MCP Server Toolkit?

Every AI agent needs tools. MCP Server Toolkit gives them file system access, web fetching, database queries, and shell commands โ€” all through a single, standardized protocol.

graph LR
    A[๐Ÿค– AI Agent] -->|MCP Protocol| B[๐Ÿ”Œ MCP Server Toolkit]
    B --> C[๐Ÿ“ File System]
    B --> D[๐ŸŒ Web Fetch]
    B --> E[๐Ÿ—„๏ธ Database]
    B --> F[๐Ÿ’ป Shell]

Related MCP server: MCP Server Toolkit

โœจ Features

Tool

Description

Status

๐Ÿ“ File System

Read, write, search, and manage files

โœ… Production Ready

๐ŸŒ Web Fetch

Fetch web pages, APIs, and download files

โœ… Production Ready

๐Ÿ—„๏ธ Database

Query PostgreSQL, MySQL, SQLite, MongoDB

โœ… Production Ready

๐Ÿ’ป Shell

Execute commands with sandboxing

โœ… Production Ready

๐Ÿ” Auth

OAuth2 / API Key / JWT authentication

๐Ÿšง Coming Soon

๐Ÿ“Š Metrics

Prometheus-compatible metrics endpoint

๐Ÿšง Coming Soon

๐Ÿš€ Quick Start

Installation

pip install mcp-server-toolkit

Run in 30 seconds

from mcp_server import MCPServer, tools

# Create server with default tools
server = MCPServer(
    name="my-agent-tools",
    tools=[tools.FileSystem(), tools.WebFetch(), tools.Database(), tools.Shell()]
)

# Start serving
server.run(port=8080)

Configuration (YAML)

# config.yaml
server:
  name: my-mcp-server
  port: 8080
  auth: none

tools:
  filesystem:
    root: /workspace
    allowed_extensions: [.py, .js, .ts, .md]
  web_fetch:
    timeout: 30
    user_agent: "MCP-Toolkit/1.0"
  database:
    url: postgresql://user:pass@localhost:5432/mydb
  shell:
    allowed_commands: [ls, cat, grep, python]
    sandbox: true
mcp-server --config config.yaml

๐Ÿ—๏ธ Architecture

mcp-server-toolkit/
โ”œโ”€โ”€ mcp_server/
โ”‚   โ”œโ”€โ”€ __init__.py          # Public API
โ”‚   โ”œโ”€โ”€ server.py            # Core MCP server
โ”‚   โ”œโ”€โ”€ protocol.py          # MCP protocol handler
โ”‚   โ””โ”€โ”€ tools/
โ”‚       โ”œโ”€โ”€ filesystem.py    # File operations
โ”‚       โ”œโ”€โ”€ web_fetch.py     # HTTP client
โ”‚       โ”œโ”€โ”€ database.py      # DB connectors
โ”‚       โ””โ”€โ”€ shell.py         # Command executor
โ”œโ”€โ”€ config.yaml.example      # Example config
โ”œโ”€โ”€ pyproject.toml
โ””โ”€โ”€ README.md

๐Ÿ“– Documentation

from mcp_server.tools import FileSystem

fs = FileSystem(root="/workspace")

# Read file
content = await fs.read("src/main.py")

# Write file
await fs.write("output.txt", "Hello, World!")

# Search files
results = await fs.search("**/*.py", pattern="import asyncio")

# List directory
files = await fs.listdir("src/", recursive=True)
from mcp_server.tools import WebFetch

web = WebFetch(timeout=30)

# Fetch page
page = await web.fetch("https://api.github.com/user")

# Download file
await web.download("https://example.com/data.csv", "local.csv")

# Parse HTML
text = await web.extract_text("https://news.ycombinator.com")
from mcp_server.tools import Database

db = Database(url="postgresql://localhost/mydb")

# Query
rows = await db.query("SELECT * FROM users WHERE active = true")

# Insert
await db.insert("users", {"name": "Alice", "role": "admin"})

# Transaction
async with db.transaction() as tx:
    await tx.execute("UPDATE accounts SET balance = balance - 100 WHERE id = 1")
    await tx.execute("UPDATE accounts SET balance = balance + 100 WHERE id = 2")

๐Ÿค Contributing

We love contributions! See CONTRIBUTING.md for guidelines.

git clone https://github.com/fzs356113-oss/mcp-server-toolkit.git
cd mcp-server-toolkit
pip install -e ".[dev]"
pytest

๐Ÿ“„ License

MIT License - see LICENSE for details.


โญ Star this repo if you find it useful! โญ

Made with โค๏ธ by fzs356113-oss

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    A comprehensive Model Context Protocol toolkit that transforms AI assistants into autonomous agents capable of executing real-world tasks across filesystems, web requests, Git workflows, databases, system commands, and AI integrations.
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    Provides AI agents with 40 tools for structured data storage, querying, web search, URL fetching, scheduled jobs, and execution through the Model Context Protocol.
    44
    115
    MIT