Global MCP Servers

This repository contains a collection of Model Context Protocol (MCP) servers that can be installed globally on your system. These servers allow LLMs like Claude to interact with various external services.

Included Servers

ComfyUI - Interact with the ComfyUI stable diffusion interface for image generation
GitHub - Perform operations on GitHub repositories, issues, and pull requests
Brave Search - Search the web using the Brave Search API
Supabase - Run SQL queries against a Supabase database

Installation

To install all MCP servers globally, run:

# Clone this repository
git clone https://github.com/ChipsMetaverse/mcp-servers.git
cd mcp-servers

# Optional: Set environment variables for API keys
export GITHUB_TOKEN="your_github_token"
export BRAVE_SEARCH_API_KEY="your_brave_search_api_key"
export SUPABASE_URL="your_supabase_url"
export SUPABASE_KEY="your_supabase_anon_key"

# Run the setup script
./bin/setup-global-mcp.sh

This will:

Create directories for each MCP server in ~/.mcp/
Copy server scripts to these directories
Configure Cursor to use these servers via ~/.cursor/mcp.json
Set up API keys if provided as environment variables

Requirements

Node.js and npm - Required for running MCP servers
curl - Used for API checks
jq - Recommended for JSON manipulation (optional but recommended)

Configuration

API keys and tokens are stored in ~/.cursor/mcp.json. You can edit this file manually if you prefer not to use environment variables. The configuration format is:

{
  "github": {
    "accessToken": "your_github_token",
    "permissions": ["repo", "admin:org", "user", "workflow", "delete_repo"]
  },
  "braveSearch": {
    "apiKey": "your_brave_search_api_key",
    "enabled": true
  },
  "comfyui": {
    "command": "~/.mcp/comfyui/run.sh",
    "args": []
  },
  "github-mcp": {
    "command": "~/.mcp/github/run.sh",
    "args": []
  },
  "brave-search": {
    "command": "~/.mcp/brave-search/run.sh",
    "args": []
  },
  "supabase": {
    "command": "~/.mcp/supabase/run.sh",
    "args": []
  }
}

Running Individual Servers

You can run each server individually:

# ComfyUI MCP Server
~/.mcp/comfyui/run.sh

# GitHub MCP Server
~/.mcp/github/run.sh

# Brave Search MCP Server
~/.mcp/brave-search/run.sh

# Supabase MCP Server
~/.mcp/supabase/run.sh

Using with LLMs

After installation, restart Cursor or Claude Desktop to apply the changes. MCP servers will be automatically available to LLMs that support the MCP protocol.

Troubleshooting

Missing API Keys: Make sure to set your API keys either through environment variables or by editing ~/.cursor/mcp.json
Server Connectivity: Each server has specific requirements:
- ComfyUI: Requires the ComfyUI server to be running on http://localhost:8188
- Supabase: Requires a running Supabase instance (local or remote)
Permissions: Ensure the run scripts have execution permissions
Node.js Version: MCP servers require Node.js v16 or later

License

MIT

mcp-servers