MCP Server Collection

A collection of Model Context Protocol (MCP) servers designed to integrate various services and APIs with AI assistants. This project provides a comprehensive hub of MCP servers that can enhance AI assistants like Claude Desktop, Cursor, GitHub Copilot, and others through the Model Context Protocol.

Overview

This project implements several MCP servers that provide integration with various services:

• Brave Search: Web search and local search functionality using the Brave Search API
• Filesystem: File system operations with security restrictions
• Git: Git repository management functionality
• GitHub: GitHub API integration for repositories, issues, pull requests, and more
• Shell: Shell command execution in a controlled environment
• Figma: Integration with Figma API for design files
• Slack: Slack API integration for messaging and channel information
• Firecrawl: Web scraping capabilities
• Notion: Notion API integration with markdown conversion for improved readability
• Think: Structured reasoning space for complex problem solving (Claude Desktop only)

Requirements

• Node.js (v18+)
• Bun as the JavaScript/TypeScript runtime
• An AI assistant that supports MCP (e.g., Claude Desktop, Cursor, GitHub Copilot)

Installation

1. Clone the repository:

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

2. Install dependencies:

   bun install
   

Configuration

To use these MCP servers with your AI assistant, you need to configure them according to your assistant:

• Claude Desktop:

  1. Open Claude Desktop
  2. Click on the menu bar and select "Settings"
  3. Navigate to the "MCP" section to configure your servers

• Cursor:

  • MCP servers can be configured through Cursor's Settings menu:
    1. Open Cursor Settings
    2. Navigate to "Features > MCP"
    3. Add your server configurations

This repository includes configuration templates in the config_templates directory:

• claude_desktop_config_template.json: Complete configuration for Claude Desktop

To use the templates:

1. Copy the appropriate template from the config_templates directory
2. Replace <YOUR_USERNAME> and <path> placeholders with your actual values
3. Add your API keys and tokens where needed
4. Import or paste the configuration into your AI assistant's settings

Note: Windows paths use backslashes (\\), while macOS or Linux use forward slashes.

Important for Cursor users: The Think tool is only compatible with Claude Desktop. If you are using Cursor, please remove the Think configuration from your mcp.json file to avoid errors.

API Keys and Tokens Setup

For each service integration, you'll need to obtain and configure the appropriate API keys:

1. Brave Search API: Sign up at Brave Search API to get your API key
2. GitHub: Create a personal access token with appropriate permissions
3. Figma: Generate an access token in your Figma account
4. Slack: Create a Slack app and generate a bot token
5. Firecrawl: Sign up for a Firecrawl API key
6. Notion: Create an integration and get the API key

Replace the placeholder values in the configuration file with your actual API keys and tokens.

Usage

1. Start your AI assistant
2. Configure the MCP servers according to your assistant's requirements
3. The assistant will now have access to all the integrated services during your conversations

Feature Details

Notion Integration

The Notion integration provides:

• Creation, retrieval, updating, and deletion of pages, databases, and blocks
• Search functionality
• Markdown conversion for improved readability
• Database querying capabilities
• Comment functionality

GitHub Integration

The GitHub integration enables:

• Repository creation, search, and management
• File retrieval, updating, and committing
• Issue and pull request management
• Multiple account support

File System

Securely access the file system with:

• File reading and writing operations
• Directory operations
• File search capabilities
• File metadata retrieval

Additional Integrations

• Brave Search: Web and local search capabilities
• Git: Repository management, commits, branch operations
• Shell: Controlled shell command execution
• Figma: Design file retrieval and operations
• Slack: Message sending and channel information retrieval
• Firecrawl: Web scraping
• Notion: Notion API integration

Think Integration

The Think integration provides:

• Structured reasoning space for complex problem solving
• Ability to break down problems into manageable steps
• Support for methodical thinking and analysis without executing actions
• Improved decision-making through guided thought processes

Note: The Think tool is exclusively compatible with Claude Desktop and will not function in Cursor or other environments. Cursor users should not include this tool in their configuration.

Development

Each MCP server is implemented as a standalone TypeScript file or directory in the src folder:

• src/brave-search.ts: Brave Search API integration
• src/filesystem.ts: File system operations
• src/git.ts: Git operations
• src/github.ts & src/github/: GitHub API integration
• src/shell.ts: Shell command execution
• src/figma.ts: Figma API integration
• src/slack.ts: Slack API integration
• src/firecrawl.ts: Web scraping
• src/notion.ts & src/notion/: Notion API integration
• src/think.ts: Structured reasoning space for complex problem solving

To add new functionality:

1. Create a new TypeScript file in the src directory
2. Implement the MCP server using the @modelcontextprotocol/sdk
3. Add the new server to your AI assistant's configuration

Security Considerations

• The filesystem and shell servers include security measures to prevent unauthorized access
• Always validate user input before executing commands
• Be cautious when configuring allowed directories for filesystem access
• Use the command allowlist for the shell server to restrict executable commands
• Store your API keys and tokens securely and follow the principle of least privilege

References and Acknowledgements

This project is based on the following repositories:

• ukkz/claude-ts-mcps - Original implementation of MCP servers collection
• suekou/mcp-notion-server - Reference implementation for Notion MCP server

Additional references:

• Model Context Protocol
• MCP Server Quickstart

License

MIT License