MCP Toolkit

🚀 MCP Toolkit

The MCP Toolkit is a comprehensive implementation of the Model Context Protocol (MCP) server. It offers a rich set of tools that enable AI assistants to interact with local systems, files, databases, and external services. It aims to expand AI's real - world interaction capabilities while maintaining security and control.

🚀 Quick Start

The MCP Toolkit provides a wide range of functionalities to empower AI assistants. To get started, you need to install and configure it properly.

✨ Features

• File System Operations

  • Read and write files
  • Create and delete directories
  • Search for files using regular expressions
  • 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
  • Repository structure analysis

• Network Capabilities

  • Web 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

📚 Documentation

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 configuration
  },
  "database": {
    "mysql": {
      "host": "localhost",
      "port": 3306,
      "user": "user",
      "password": "password",
      "database": "dbname"
    }
    // Similarly configure for PostgreSQL and Redis
  }
}

Usage

import { Server } from 'mcp-toolkit';

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

server.start();

💻 Usage Examples

Basic Usage

The following code shows how to start the MCP server with a configuration file:

import { Server } from 'mcp-toolkit';

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

server.start();

🔧 Technical Details

File Operation Tools

• read_file: Read file contents, supporting text and binary files
• write_to_file: Write to or create a file
• apply_diff: Apply differential modifications to a file
• insert_content: Insert content at a specified position
• search_and_replace: Search for and replace content in a file
• list_files: List directory contents
• search_files: Search for files using regular expressions
• list_code_definition_names: Extract code definitions

Database Tools

• db_connect: Connect to a database (MySQL/PostgreSQL/Redis)
• db_query: Execute a database query
• db_begin_transaction: Begin a transaction
• db_commit_transaction: Commit a transaction
• db_rollback_transaction: Roll back a transaction
• db_close: Close the database connection

GitHub Tools

• github_ls: List repository contents
• github_tree: Display the repository structure
• github_search_repo: Search for repositories
• github_search_code: Search for code
• github_cat: View file contents
• github_list_repos: List user repositories
• github_create_repo: Create a repository
• github_update_repo: Update repository settings
• github_delete_repo: Delete a repository

Network Tools

• read_webpage: Extract web page content
• brave_search: Use Brave search
• http_request: Send an HTTP request

System Tools

• execute_command: Execute a system command
• everything_search: Local file search
• logger: Logging
• stack_trace: Stack trace

🔒 Security

The MCP Toolkit supports the configuration of security measures, such as protecting your data and network by setting up a proxy and restricting access paths.

🤝 Contribution Guidelines

We welcome contributions from the community to the MCP Toolkit! Please refer to our Contribution Guidelines to learn how to participate in the development.

📄 License

The MCP Toolkit is licensed under the MIT License.