Name: 开发工具MCP服务器
Author: mark1russell7

使用说明

Moved. This package now lives in mark1russell7/client, with its full history. This repository is archived.

@mark1russell7/impl-mcp-dev

Ready-to-use MCP server exposing the procedure ecosystem to Claude Desktop and Claude Code.

Overview
Quick Start
Architecture
Claude Desktop Setup
Claude Code Setup
Configuration
Available Tools
How It Works
Troubleshooting
Requirements
License

Overview

impl-mcp-dev is the ready-to-run MCP server for the Mark ecosystem:

Zero Configuration - Works out of the box with sensible defaults
Dynamic Bundle Loading - Configure which procedure bundles to expose
Claude Integration - Works with both Claude Desktop and Claude Code
Debug Mode - Detailed logging for troubleshooting

Quick Start

npx @mark1russell7/impl-mcp-dev

Architecture

System Overview

graph TB
    subgraph "Claude"
        Desktop[Claude Desktop]
        Code[Claude Code]
    end

    subgraph "Configuration"
        Config[claude_desktop_config.json<br/>or ~/.claude.json]
    end

    subgraph "impl-mcp-dev"
        Entry[Entry Point]
        Loader[Bundle Loader]
        Server[MCP Server]
    end

    subgraph "Bundles"
        Dev[bundle-dev<br/>Full toolkit]
        MCP[bundle-mcp<br/>AI-optimized]
        Custom[Custom bundles]
    end

    subgraph "Procedure Registry"
        FS[fs.*]
        Git[git.*]
        Shell[shell.*]
        Docker[docker.*]
        Mongo[mongo.*]
    end

    Desktop --> Config
    Code --> Config
    Config -->|MCP_BUNDLES| Entry
    Entry --> Loader
    Loader --> Dev
    Loader --> MCP
    Loader --> Custom
    Dev --> FS
    Dev --> Git
    Dev --> Shell
    MCP --> Docker
    MCP --> Mongo
    Server --> FS
    Server --> Git
    Server --> Shell
    Server --> Docker
    Server --> Mongo

Startup Flow

sequenceDiagram
    participant Claude as Claude
    participant Config as Config File
    participant Entry as impl-mcp-dev
    participant Loader as Bundle Loader
    participant Registry as PROCEDURE_REGISTRY
    participant MCP as MCP Transport

    Claude->>Config: Read mcpServers
    Config-->>Claude: { command, args, env }
    Claude->>Entry: Start (MCP_BUNDLES env)

    Entry->>Entry: Parse MCP_BUNDLES
    loop For each bundle
        Entry->>Loader: import(bundle/register.js)
        Loader->>Registry: Register procedures
    end

    Entry->>MCP: Create McpServerTransport
    MCP->>MCP: Convert procedures to tools
    MCP-->>Claude: Ready (stdio connected)

    Note over Claude,MCP: Tools now available

Bundle Composition

graph TB
    subgraph "bundle-dev (Full)"
        DevFS[client-fs]
        DevGit[client-git]
        DevShell[client-shell]
        DevPnpm[client-pnpm]
        DevLib[client-lib]
        DevDocker[client-docker]
        DevMongo[client-mongo]
    end

    subgraph "bundle-mcp (AI-optimized)"
        McpLib[client-lib]
        McpDocker[client-docker]
        McpMongo[client-mongo]
        McpVitest[client-vitest]
        McpCue[client-cue]
    end

    subgraph "Use Case"
        Full[Development CLI]
        AI[Claude Integration]
    end

    DevFS --> Full
    DevGit --> Full
    DevShell --> Full
    McpLib --> AI
    McpDocker --> AI
    McpMongo --> AI

Claude Desktop Setup

Step 1: Locate Configuration File

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Step 2: Add MCP Server Configuration

{
  "mcpServers": {
    "dev-tools": {
      "command": "npx",
      "args": ["@mark1russell7/impl-mcp-dev"],
      "env": {
        "MCP_BUNDLES": "@mark1russell7/bundle-mcp"
      }
    }
  }
}

Step 3: Restart Claude Desktop

Quit and reopen Claude Desktop. Tools will appear in Claude's tool list.

Claude Code Setup

Add to ~/.claude.json

{
  "projects": {
    "C:/Users/YOUR_USERNAME/git": {
      "mcpServers": {
        "dev-tools": {
          "type": "stdio",
          "command": "node",
          "args": ["C:/Users/YOUR_USERNAME/git/impl-mcp-dev/dist/server.js"],
          "env": {
            "MCP_BUNDLES": "@mark1russell7/bundle-mcp",
            "MONGODB_URI": "mongodb://localhost:27017"
          }
        }
      }
    }
  }
}

Verify Connection

Run /mcp in Claude Code to see connected servers.

Configuration

Environment Variables

Variable	Default	Description
`MCP_BUNDLES`	`@mark1russell7/bundle-dev`	Comma-separated list of bundles to load
`MCP_SERVER_NAME`	`impl-mcp-dev`	Server name for MCP protocol
`MCP_SERVER_VERSION`	`1.0.0`	Server version for MCP protocol
`MCP_DEBUG`	`false`	Enable debug logging (outputs to stderr)
`MONGODB_URI`	-	MongoDB connection string (for mongo.* procedures)

Loading Multiple Bundles

{
  "mcpServers": {
    "full-tools": {
      "command": "npx",
      "args": ["@mark1russell7/impl-mcp-dev"],
      "env": {
        "MCP_BUNDLES": "@mark1russell7/bundle-dev,@mark1russell7/bundle-mcp",
        "MCP_DEBUG": "true"
      }
    }
  }
}

Local Development Setup

{
  "mcpServers": {
    "dev-tools": {
      "command": "node",
      "args": ["C:/Users/me/git/impl-mcp-dev/dist/server.js"],
      "env": {
        "MCP_BUNDLES": "@mark1russell7/bundle-mcp",
        "MCP_DEBUG": "true"
      }
    }
  }
}

Available Tools

With bundle-mcp (Recommended for Claude)

Namespace	Procedures	Description
`cli.*`	1	Mark CLI wrapper
`lib.*`	8	Ecosystem management
`procedure.*`	9	Procedure management
`cue.*`	5	Configuration generation
`docker.*`	12	Docker container management
`mongo.*`	16	MongoDB operations
`vitest.*`	2	Test runner

With bundle-dev (Full toolkit)

Includes all of the above plus:

Namespace	Procedures	Description
`fs.*`	15	File system operations
`git.*`	14	Git operations
`shell.*`	3	Shell command execution
`pnpm.*`	8	Package management

How It Works

Startup: Reads MCP_BUNDLES environment variable
Bundle Loading: Dynamically imports each bundle's /register.js
Procedure Registration: Side-effect imports register procedures to PROCEDURE_REGISTRY
MCP Transport: McpServerTransport exposes procedures as MCP tools
Tool Execution: Claude calls tools → transport routes to procedure handlers

Troubleshooting

Tools not appearing in Claude

Check Claude Desktop logs for errors
Enable debug mode: "MCP_DEBUG": "true"
Verify bundles are installed: npm ls @mark1russell7/bundle-mcp
Restart Claude Desktop

Server fails to start

Ensure Node.js v20+ is installed
Check bundle paths are correct
Run manually to see errors: npx @mark1russell7/impl-mcp-dev

Connection issues

Restart Claude Desktop
Check claude_desktop_config.json syntax (valid JSON)
Verify command path is correct (npx should be in PATH)
Use absolute paths if relative paths don't work

Debug Logging

Enable debug mode to see detailed logs:

{
  "env": {
    "MCP_DEBUG": "true"
  }
}

Logs output to stderr and won't interfere with the MCP protocol.

Requirements

Node.js >= 20
Claude Desktop or Claude Code
Dependencies:
- @mark1russell7/client
- @mark1russell7/client-mcp
- @mark1russell7/mcp
- One or more bundle packages

License

MIT