MCP Server Collection

🚀 MCP Server Collection

This is a collection of Model Context Protocol (MCP) servers that integrate various services and APIs. It aims to enhance the capabilities of AI assistants, such as Claude Desktop, Cursor, GitHub Copilot, etc.

🚀 Quick Start

This project implements multiple MCP servers, supporting the integration of the following services:

• Brave Search: Provide web search functionality using the Brave Search API.
• File System: Manage local file and directory operations.
• Git: Perform Git version control operations.
• GitHub: Interact with GitHub repositories.
• Shell: Execute commands in the terminal.
• Figma: Manipulate Figma design resources.
• Slack: Communicate with Slack.
• Firecrawl: Conduct web crawling tasks.
• Notion: Manipulate data in the Notion workspace.
• Think: Provide a structured reasoning environment for complex problems.

📦 Installation

1. Clone this repository to your local machine:

   git clone https://github.com/yourusername/mcp-server.git
   cd mcp-server
   

2. Install the dependencies:

   npm install
   

3. Start the MCP server:

   • For the development environment, run npm run dev.
   • For the production environment, use PM2 to manage the process.

📚 Documentation

The configuration for each MCP server is located in the config directory of the project. Please modify the following content according to your needs:

• API Keys: Add all necessary API credentials in secrets.json.
• Allowed Directories: Specify the authorized paths for file system operations in filesystem.json.
• Command Whitelist: Define the allowed Shell commands in shell.json.

💻 Usage Examples

Basic Usage

1. Add the MCP servers to your AI assistant configuration:

   {
     "servers": [
       { "name": "brave-search", "url": "http://localhost:3000" },
       { "name": "filesystem", "url": "http://localhost:3001" },
       // Add other server configurations
     ]
   }
   

2. Import the required modules in your AI assistant code:

   import { FileSystem } from './src/filesystem';
   const fs = new FileSystem();
   

✨ Features

File System

• Read File: Retrieve the content of a file at a specified path.
• Write File: Create or overwrite a file and write new content.
• List Directory: Return all files and sub - directories in a specified directory.
• Delete Operation: Delete a file or an empty directory.

Git Operations

• Clone Repository: Clone a Git repository from a remote URL to the local machine.
• Commit Changes: Commit modified files to the current branch.
• Switch Branch: Switch between different Git branches.
• Pull Updates: Fetch the latest code from the remote repository and merge it into the current branch.

GitHub Integration

• Create New Repository: Create a new GitHub repository using the API.
• Fork Repository: Create a fork of an existing repository.
• Commit Changes: Push local modifications to a specified remote repository.
• Get Repository Information: Retrieve detailed information about a specific repository, including contributors and branches.

Shell Commands

• Execute Command: Run a user - provided command in the terminal.
• Get Output: Return the standard output, error output, and exit status code of a command.
• File Operations: Support renaming, deleting, and creating new files or directories.

Figma Design

• Create Page: Add a new design page to a Figma project.
• Get Component: Retrieve detailed information about a specific component, including its properties and version history.
• Update Layout: Modify the position and size of elements on a page.
• Export Resources: Export selected design assets in multiple formats.

Slack Communication

• Send Message: Send a text or Markdown - formatted message to a specified channel.
• Get Chat History: Retrieve the chat history within a specific time period.
• Add Attachment: Upload a file and attach it to a message.
• Direct Message: Send a private message to a specific user.

Web Crawling

• Start Crawler: Initialize a crawler task using a specified URL.
• Get Results: Retrieve the crawled data, including HTML content and links.
• Set Rules: Define the behavior of the crawler, such as crawling depth and excluding specific URLs.
• Abort Task: Stop the current crawler task at any time.

Notion Workspace

• Create Page: Add a new Notion page or database entry.
• Get Content: Retrieve all records in a specified page or database.
• Update Information: Modify the content and properties of an existing page or database entry.
• Delete Data: Remove unnecessary content from the workspace.

Complex Problem Reasoning

• Submit Query: Decompose a complex problem into multiple subtasks and analyze and solve them one by one.
• Get Intermediate Results: Obtain the output of each step during the reasoning process.
• Final Answer: Return a verified final conclusion and relevant supporting evidence.

🔧 Technical Details

Security Precautions

1. Permission Management: Strictly limit API access permissions to avoid unauthorized operations.
2. Input Filtering: Perform strict validation and sanitization on user - provided input to prevent injection attacks.
3. Logging: Record all sensitive operation logs for auditing and troubleshooting.

Frequently Asked Questions

1. How to handle large - file uploads?

   • Use a chunked upload mechanism and set an appropriate timeout strategy.

2. What to do if a Git operation fails?

   • Check the network connection and repository permissions, and ensure that all credentials are correctly configured.

3. How to improve performance?

   • Optimize database queries and reduce unnecessary network requests.

Contribution Guidelines

1. Before submitting code, ensure that it passes unit tests.
2. Follow the project's coding standards and maintain a consistent code style.
3. Before submitting a Pull Request, refer to the contributor documentation for more details.