DIP MCP

Codeup repository management MCP server for Claude Code and other MCP-compatible tools.

Installation

From npm (recommended)

# Global install
npm install -g @treedy2026/dip-mcp

# Or use npx directly
npx @treedy2026/dip-mcp init

From source

git clone https://codeup.aliyun.com/5f37cb7a769820a3e81810fc/WelcomeDIP.git
cd WelcomeDIP/mcp-client
npm install
npm run build
npm link  # Makes 'dip-mcp' available globally

Quick Start

# 1. Initialize with your Codeup token
dip-mcp init

# 2. Verify configuration
dip-mcp status

# 3. Add to Claude Code (choose one method)

# Method A: Command line
jq '.mcpServers["dip-codeup"] = {
  "type": "stdio",
  "command": "npx",
  "args": ["@treedy2026/dip-mcp", "serve"],
  "env": {}
}' ~/.claude.json > ~/.claude.json.tmp && mv ~/.claude.json.tmp ~/.claude.json

# Method B: Manual edit ~/.claude.json
# Method C: Create .mcp.json in project root

# 4. Restart Claude Code and verify with /mcp

Commands

| Command | Description | |---------|-------------| | dip-mcp init | Configure Codeup token and organization | | dip-mcp serve | Start MCP server (auto-starts web dashboard) | | dip-mcp serve --no-web | Start MCP server without web dashboard | | dip-mcp web | Start local web dashboard only | | dip-mcp web -p 8080 | Custom port for web dashboard | | dip-mcp status | Show configuration status | | dip-mcp orgs | List available organizations | | dip-mcp test | Test connection to Codeup | | dip-mcp logout | Remove stored credentials |

MCP Tools (19 total)

Repository & Files

| Tool | Description | |------|-------------| | codeup.repos.list | List accessible repositories | | codeup.repos.get | Get repository details | | codeup.tree | List files in a repository | | codeup.file.read | Read file content | | codeup.orgs.list | List available organizations |

Branch Operations

| Tool | Description | |------|-------------| | codeup.branch.list | List branches | | codeup.branch.create | Create a new branch | | codeup.branch.delete | Delete a branch |

File Write Operations

| Tool | Description | |------|-------------| | codeup.file.create | Create a new file (commits directly) | | codeup.file.update | Update an existing file (commits directly) | | codeup.file.delete | Delete a file (commits directly) |

Merge Requests

| Tool | Description | |------|-------------| | codeup.mr.list | List merge requests | | codeup.mr.get | Get merge request details | | codeup.mr.create | Create a new merge request |

Issue Management

| Tool | Description | |------|-------------| | codeup.issue.list | List issues (bugs, tasks, requirements) | | codeup.issue.get | Get issue details | | codeup.issue.create | Create a new issue |

Recommendations

| Tool | Description | |------|-------------| | recommend.skills | List recommended Claude Code Skills | | recommend.mcp | List recommended MCP servers |

Web Dashboard

When MCP starts, a web dashboard is automatically available at:

http://localhost:3456

Features:

• Frontend documentation viewer
• /api/health - Health check
• /api/recommendations - Recommended Skills and MCP servers

Disable auto-start: dip-mcp serve --no-web

Configuration

Claude Code (Global)

Edit ~/.claude.json:

{
  "mcpServers": {
    "dip-codeup": {
      "type": "stdio",
      "command": "npx",
      "args": ["@treedy2026/dip-mcp", "serve"]
    }
  }
}

Claude Code (Project-level)

Create .mcp.json in project root:

{
  "mcpServers": {
    "dip-codeup": {
      "command": "npx",
      "args": ["@treedy2026/dip-mcp", "serve"]
    }
  }
}

Other MCP Clients (Cursor, Continue, etc.)

{
  "name": "dip-codeup",
  "transport": "stdio",
  "command": "npx",
  "args": ["@treedy2026/dip-mcp", "serve"]
}

Example Usage

Ask Claude Code to:

- "List my Codeup repositories"
- "Show the directory structure of WelcomeDIP"
- "Read the README.md from repository 6151599"
- "Create a new branch 'feature/login' from master"
- "Create a file src/hello.py with hello world code"
- "Create a merge request from feature/login to master"
- "Create a bug: Login page is broken"
- "List all open bugs"
- "What Skills do you recommend?"

Security

• Personal Access Token stored locally in user config directory
• Tokens never sent to any server except Codeup API
• All API requests use HTTPS
• Write operations restricted to configured repositories

Development

# Install dependencies
npm install

# Build
npm run build

# Run locally
node dist/cli.js serve

# Watch mode
npm run dev

Requirements

• Node.js 18+
• Codeup Personal Access Token (Get one here)

License

MIT - DIP AI Center