Impl MCP Dev

@mark1russell7/impl mcp开发

即用型MCP服务器将程序生态系统暴露给Claude Desktop和Claude Code。

目录

• 概述
• 快速开始
• 建筑
• Claude桌面设置
• Claude代码设置
• 配置
• 可用工具
• 运作原理
• 故障排除
• 需求
• 许可证

______________________________________________________________________

概述

impl mcp开发 Mark生态系统的MCP服务器是否已准备就绪：

• 零配置 -使用合理的默认值即可开箱即用
• 动态捆绑加载 -配置要公开的程序包
• 克劳德集成 -适用于Claude Desktop和Claude Code
• 调试模式 -用于故障排除的详细日志记录

______________________________________________________________________

快速开始

npx @mark1russell7/impl-mcp-dev

______________________________________________________________________

建筑

系统概述

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

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

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

    subgraph "Bundles"
        Dev[bundle-dev
Full toolkit]
        MCP[bundle-mcp
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

启动流程

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

捆绑组成

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桌面设置

步骤1：查找配置文件

窗户： %APPDATA%\Claude\claude_desktop_config.json macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

步骤2：添加MCP服务器配置

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

步骤3：重新启动克劳德桌面

退出并重新打开Claude Desktop。工具将出现在Claude的工具列表中。

______________________________________________________________________

Claude代码设置

添加到~/.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"
          }
        }
      }
    }
  }
}

验证连接

跑 /mcp 在Claude Code中查看连接的服务器。

______________________________________________________________________

配置

环境变量

装载多个捆包

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

地方发展设置

{
  "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"
      }
    }
  }
}

______________________________________________________________________

可用工具

使用捆绑包mcp（推荐给Claude）

使用bundle dev（完整工具包）

包括上述所有内容以及：

______________________________________________________________________

运作原理

1. 启动： 倒像 MCP_BUNDLES 环境变量
2. 捆绑加载： 动态导入每个捆绑包的 /register.js
3. 程序注册： 副作用进口登记程序 PROCEDURE_REGISTRY
4. MCP运输： McpServerTransport 将程序作为MCP工具公开
5. 工具执行： 克劳德称工具→ 程序处理程序的传输路径

______________________________________________________________________

故障排除

工具未出现在Claude中

1. 检查Claude Desktop日志是否有错误
2. 启用调试模式： "MCP_DEBUG": "true"
3. 验证捆绑包是否已安装： npm ls @mark1russell7/bundle-mcp
4. 重新启动克劳德桌面

服务器无法启动

1. 确保已安装Node.js v20+
2. 检查捆绑包路径是否正确
3. 手动运行以查看错误： npx @mark1russell7/impl-mcp-dev

连接问题

1. 重新启动克劳德桌面
2. 检查 claude_desktop_config.json 语法（有效的JSON）
3. 验证 command 路径正确(npx 应该在PATH中）
4. 如果相对路径不起作用，请使用绝对路径

调试日志记录

启用调试模式以查看详细日志：

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

将输出记录到stderr，不会干扰MCP协议。

______________________________________________________________________

需求

• Node.js >= 20
• 克劳德桌面版 或 克劳德代码
• 依赖关系：

- @mark1russell7/client - @mark1russell7/client-mcp - @mark1russell7/mcp - 一个或多个捆绑包

______________________________________________________________________

许可证

麻省理工学院