Claude 开发套件

Prerequisites

• Node.js v20+ - Required to build MCP servers and run the dashboard
• npm - Comes with Node.js
• Git - Required for cloning dev-suite and the knowledge base
• Claude Code - The Anthropic CLI tool that dev-suite extends

Optional: - Docker - Required if using the docker-manager MCP server - Database - Required if using the database-query MCP server (PostgreSQL, MySQL, etc.)

---

Custom Agents Builder

Create and manage custom agents directly from the dashboard:

• Visual Editor - Write agent markdown with YAML frontmatter
• Skill Association - Link agents to specific skills and MCP servers
• Instant Deployment - Agents are saved to .claude/agents/ and immediately available
• Edit & Delete - Manage existing custom agents from the dashboard

---

Installation Modes

Docker Manager Server

Manage Docker containers, images, and Compose services.

Tools: - docker_ps({ all? }) - List running containers - docker_container({ container, action, tail? }) - Manage container (start/stop/logs/inspect) - docker_compose({ action, service?, build?, detach? }) - Manage Compose services - docker_images({ action, image? }) - Manage images - docker_stats({ container? }) - View resource usage - docker_networks() - List networks - docker_volumes() - List volumes - cleanup_unused({ target?, dryRun?, force? }) - Remove unused resources

---

2. Rebuild all MCP servers

cd mcp-servers && npm install && npm run build

3. Sync installed projects (run in each project)

/path/to/dev-suite/init-project.sh /path/to/your-project ```

Then restart Claude Code to reload the updated MCP servers.

Quick Start

Prefer a one-click installer? Skip the clone step and jump to Desktop App Downloads for Windows / macOS / Linux pre-built installers.

Usage

`.dev-suite.json` Example

{
  "version": "1.0.0",
  "project": {
    "name": "my-app",
    "type": "fullstack",
    "isMonorepo": false
  },
  "mcpServers": [
    "documentation",
    "database-query",
    "docker-manager",
    "api-tester",
    "dashboard-bridge"
  ],
  "stacks": {
    "frontend": {
      "framework": "react",
      "metaFramework": "nextjs",
      "styling": "tailwindcss",
      "stateManagement": "zustand+tanstack-query"
    },
    "backend": {
      "runtime": "nodejs",
      "framework": "nestjs",
      "apiStyle": "rest"
    },
    "database": {
      "type": "postgresql",
      "orm": "prisma"
    },
    "testing": {
      "unit": "vitest",
      "e2e": "playwright"
    }
  },
  "git": {
    "provider": "github",
    "repository": "https://github.com/owner/my-app",
    "tokenEnvVar": "GITHUB_TOKEN"
  },
  "agents": {
    "enabled": [
      "architect",
      "code-reviewer",
      "react-expert",
      "nextjs-expert",
      "nestjs-expert",
      "prisma-expert",
      "vitest-expert",
      "playwright-expert",
      "docker-expert"
    ]
  }
}

Optional: use a custom KB repository (defaults to official repo)

KB_REPO_URL=https://github.com/claude-dev-suite/knowledge_base.git

Optional: cache TTL in seconds (default: 7200 = 2 hours)

KB_CACHE_TTL=7200 ```

Adding documentation to the KB:

1. Clone the KB repository: git clone https://github.com/claude-dev-suite/knowledge_base.git
2. Add markdown files under knowledge/{technology}/{topic}.md
3. Update the relevant category file in mcp-servers/documentation/src/docs-index/ (e.g., testing.ts, backend.ts) to register the new technology — docs-index.ts is a re-export aggregator, do not edit it directly
4. Commit and push - the documentation MCP server will fetch new docs automatically on next request

---

Configuration

Environment Variables

Create a .env file in your project root:

```bash

Optional: Dashboard ports

DASHBOARD_PORT=3456 ORCHESTRATOR_WS_PORT=3457

Optional: Documentation KB (defaults to official repo)

KB_REPO_URL=https://github.com/claude-dev-suite/knowledge_base.git KB_CACHE_TTL=7200 ```

Security Note: Never commit .env files. API tokens are only referenced by variable name in .dev-suite.json.

---

MCP Servers Reference

API Tester Server

Test REST APIs with requests, collection import, and mock servers.

Tools: - http_request({ method, url, headers?, body?, timeout? }) - Make HTTP request - health_check({ url, endpoints? }) - Check API health - batch_request({ requests, sequential? }) - Execute multiple requests - import_collection({ filePath, format?, variables? }) - Import Postman or Insomnia collection (auto-detects format) - generate_tests({ specPath, outputFormat?, includeNegativeTests? }) - Generate test cases from OpenAPI - mock_server({ action, specPath?, port?, delay? }) - Start/stop mock server

---

API Explorer Server

Explore OpenAPI/Swagger schemas and endpoints.

Tools: - list_api_endpoints() - List configured API endpoints - get_api_schema({ alias?, format?, refresh? }) - Fetch OpenAPI schema - list_api_paths({ alias?, method?, tag?, limit? }) - List API paths - get_api_endpoint_details({ path, method, alias?, resolveRefs? }) - Get endpoint details - get_api_models({ alias?, model?, compact?, limit? }) - Get schema models/DTOs - search_api({ query, alias?, searchIn?, limit? }) - Search across specs - detect_api_frameworks({ path?, maxDepth?, includeConfidence? }) - Detect API frameworks

Configuration: API endpoints configured via .dev-suite.json or auto-detected from OpenAPI specs.

---

Agents Reference

Commands Reference

Slash commands available in Claude Code after initialization:

---