What is Mcp Toolkit

MCP Toolkit is a comprehensive Model Context Protocol (MCP) server implementation that enables AI assistants to interact with local systems, files, databases, and external services, enhancing AI capabilities with real-world interactions while ensuring security and control.

Use cases

Use cases for MCP Toolkit include automating file management tasks, integrating AI with databases for data retrieval and manipulation, performing web scraping to extract information, and managing GitHub repositories through AI-driven commands.

How to use

To use MCP Toolkit, install it via npm with ‘npm install mcp-toolkit’. Then, create a ‘config.json’ file to configure your workspace, network, and database settings. Finally, import the toolkit in your TypeScript code and start the server using ‘server.start()’.

Key features

Key features of MCP Toolkit include file system operations (reading/writing files, directory management), database integration (support for MySQL, PostgreSQL, Redis), GitHub integration (repository management, code search), web capabilities (content extraction, HTTP handling), and system tools (command execution, logging).

Where to use

MCP Toolkit can be used in various fields such as AI development, data analysis, web scraping, and automation tasks where AI assistants need to interact with local and external resources.

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.

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:

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