MCP Toolkit

English | 中文

Overview

MCP Toolkit is a comprehensive Model Context Protocol (MCP) server implementation that provides a rich set of tools for AI assistants to interact with the local system, files, databases, and external services. It's designed to extend AI capabilities with real-world interactions while maintaining security and control.

Related MCP server: MCP Python Toolbox

Features

• File System Operations

  • Read and write files

  • Create and delete directories

  • Search files with regex patterns

  • List directory contents

  • Extract code definitions

• Database Integration

  • MySQL support

  • PostgreSQL support

  • Redis support

  • Transaction management

  • Parameterized queries

• GitHub Integration

  • Repository management

  • Code search

  • File operations

  • Tree structure analysis

• Web Capabilities

  • Web page content extraction

  • Brave search integration

  • HTTP request handling

  • Proxy support

• System Tools

  • Command execution

  • Everything search integration

  • Stack trace analysis

  • Logging system

Installation

npm install mcp-toolkit

Configuration

Create a config.json file in your project:

{
  "workspace": {
    "rootPath": "/path/to/workspace",
    "allowedPaths": ["/allowed/path1", "/allowed/path2"]
  },
  "network": {
    "proxy": "http://proxy-server:port"  // Optional
  },
  "database": {
    "mysql": {
      "host": "localhost",
      "port": 3306,
      "user": "user",
      "password": "password",
      "database": "dbname"
    }
    // Similar configuration for PostgreSQL and Redis
  }
}

Usage

import { Server } from 'mcp-toolkit';

const server = new Server({
  configPath: './config.json'
});

server.start();

Tool Details

File Operation Tools

• read_file: Read file contents, supports text and binary files

• write_to_file: Write or create files

• apply_diff: Apply differential modifications to files

• insert_content: Insert content at specified positions

• search_and_replace: Search and replace file contents

• list_files: List directory contents

• search_files: Search files using regex

• list_code_definition_names: Extract code definitions

Database Tools

• db_connect: Connect to databases (MySQL/PostgreSQL/Redis)

• db_query: Execute database queries

• db_begin_transaction: Start transaction

• db_commit_transaction: Commit transaction

• db_rollback_transaction: Rollback transaction

• db_close: Close database connection

GitHub Tools

• github_ls: List repository contents

• github_tree: Display repository tree structure

• github_search_repo: Search repositories

• github_search_code: Search code

• github_cat: View file contents

• github_list_repos: List user repositories

• github_create_repo: Create repository

• github_update_repo: Update repository settings

• github_delete_repo: Delete repository

Web Tools

• read_webpage: Extract webpage content

• brave_search: Use Brave search

• http_request: Send HTTP requests

System Tools

• execute_command: Execute system commands

• everything_search: Local file search

• logger: Logging

• get_stack_trace: Stack trace analysis

Security

• Configurable workspace restrictions

• Command execution controls

• Database access management

• Token-based authentication for external services

Contributing

Contributions are welcome! Please read our Contributing Guidelines for details.

License

MIT License