MCP Tools Suite

Created By

SpaceDudem8 months ago

Comprehensive toolkit for managing Model Context Protocol (MCP) servers

# mcp-tools

# mcp-servers

Overview Content Tools Comments

Content

MCP Tools Suite

A comprehensive toolkit for managing Model Context Protocol (MCP) servers with Claude Desktop and other MCP clients.

🚀 Features

Interactive Server Selector UI: Select and configure MCP servers through a user-friendly interface
Command-line Installer: Install and manage MCP servers with an intuitive CLI
Server Bootloader: Launch and manage multiple MCP servers simultaneously
Comprehensive Documentation: Detailed guides for MCP server configuration and usage

📋 Prerequisites

Node.js (v18.x or newer)
npm (v9.x or newer)
Python (v3.9+ for Python-based servers)
uv/uvx (recommended for Python servers)

🔧 Installation

# Install the package globally
npm install -g mcp-tools-suite

# Or clone the repository
git clone https://github.com/SpaceDudem/mcp-tools-suite.git
cd mcp-tools-suite

# Install dependencies
npm install

# Make scripts executable
chmod +x src/installer/mcp-installer.js src/bootloader/mcp-bootloader.js

📖 Usage

Server Selector (UI)

Launch the web-based Server Selector:

npx mcp-selector
# Or if you've cloned the repo:
npm run ui

The UI allows you to:

Browse available MCP servers by category
Select servers to include in your configuration
Configure server arguments and environment variables
Copy the generated configuration to your clipboard

Server Installer (CLI)

npx mcp-installer
# Or if you've cloned the repo:
./src/installer/mcp-installer.js

The installer:

Checks prerequisites on your system
Guides you through server selection and configuration
Saves the configuration to Claude Desktop's config file
Tests server connectivity

Server Bootloader

npx mcp-bootloader
# Or if you've cloned the repo:
./src/bootloader/mcp-bootloader.js

# Launch specific servers
npx mcp-bootloader --server filesystem --server github

🌟 Supported Server Types

JavaScript/TypeScript Servers (npx)

filesystem - File operations with configurable access controls
memory - In-memory storage for cross-tool data persistence
github - Repository management and GitHub API integration
postgres - Database integration with PostgreSQL
brave-search - Web search capabilities
And many more...

Python Servers (uvx/pip)

git - Git repository manipulation
fetch - Web content fetching and conversion
sqlite - SQLite database integration
And many more...

🔍 Configuration

Claude Desktop configuration is stored at:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
Linux: ~/.config/claude/claude_desktop_config.json

The configuration format follows this structure:

{
  "mcpServers": {
    "server-name": {
      "command": "executable",
      "args": ["array", "of", "arguments"],
      "env": {
        "ENV_VAR_NAME": "value"
      }
    }
  }
}

🧩 Examples

Basic MCP Configuration

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"]
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

Configuration with Environment Variables

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

🛠️ Troubleshooting

Common Issues

Server Connection Failures: Ensure paths are correct and absolute
Missing Environment Variables: Check if required API keys are properly set
Windows Issues: Try using absolute paths and run Claude Desktop as administrator

For detailed troubleshooting, see docs/mcp-servers-rules.md.