DarkHeart01/devgear-mcp-server

DevGear MCP Server

A standalone Model Context Protocol (MCP) server providing development tools integration for GitHub, Docker, and Vercel operations.

Installation

Using uvx (Recommended)

uvx --from git+https://github.com/DarkHeart01/devgear-mcp-server devgear-mcp

From Source

git clone https://github.com/DarkHeart01/devgear-mcp-server
cd devgear-mcp-server
pip install -e .

Configuration

Environment Variables

Set the following environment variables for full functionality:

# GitHub integration
export GITHUB_TOKEN="your_github_personal_access_token"

# Vercel integration (optional)
export VERCEL_TOKEN="your_vercel_api_token"

# Docker integration is automatic if Docker is running

MCP Client Configuration

Add to your MCP client's settings.json:

{
  "mcpServers": {
    "devgear": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/DarkHeart01/devgear-mcp-server",
        "devgear-mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "your_github_token_here",
        "VERCEL_TOKEN": "your_vercel_token_here"
      }
    }
  }
}

Features

GitHub Tools

• github_list_repositories - List user repositories
• github_create_repository - Create new repositories
• github_get_repository - Get repository details
• github_list_issues - List repository issues
• github_create_issue - Create new issues

Docker Tools

• docker_list_containers - List containers
• docker_create_container - Create and start containers
• docker_stop_container - Stop containers
• docker_remove_container - Remove containers
• docker_get_logs - Get container logs

Vercel Tools

• vercel_list_projects - List projects
• vercel_get_project - Get project details
• vercel_list_deployments - List deployments
• vercel_get_deployment - Get deployment details

Usage Examples

Using with Claude Desktop

1. Add the configuration to your settings.json
2. Restart Claude Desktop
3. Use natural language to interact with your development tools:

"List my GitHub repositories"
"Create a new repository called 'my-project'"
"Show me the running Docker containers"
"Deploy my project to Vercel"

Direct Usage

# Start the MCP server
devgear-mcp

# The server will communicate via JSON-RPC over stdin/stdout

Development

Setup Development Environment

git clone https://github.com/DarkHeart01/devgear-mcp-server
cd devgear-mcp-server
pip install -e ".[dev]"

Running Tests

pytest

Code Formatting

black src/
ruff check src/

License

MIT License - see LICENSE file for details. "# devgear-mcp-server"