依赖分析工具

git clone https://github.com/your-username/dependency-buster.git
cd dependency-buster

# Build all implementations
./build-all.sh

# Interactive mode (will prompt)
./build-all.sh
# Enter repository URL or press Enter for default (AzuraCast)

# Non-interactive mode (uses environment variable)
TEST_REPO_URL=https://github.com/myorg/myproject.git ./build-all.sh

# Non-interactive mode (uses default)
echo "" | ./build-all.sh  # Pipes empty input to auto-select default

# TypeScript
cd dpb-mcp-typescript && npm install && npm run build

# Go
cd dpb-mcp-go && make build

# Rust  
cd dpb-mcp-rust && cargo build --release

# Analyze current directory
cd your-project
/path/to/dependency-buster/dpb-benchmark/scripts/run-benchmark.sh .

# Analyze specific project
/path/to/dependency-buster/dpb-benchmark/scripts/run-benchmark.sh /path/to/project

# Open the generated dashboard
open dpb-benchmark/dashboard/index.html

# Or view terminal report (generated automatically)

{
  "mcpServers": {
    "dependency-buster": {
      "command": "node",
      "args": ["/path/to/dpb-mcp-typescript/build/server.js"]
    }
  }
}

{
  "dependency-buster": {
    "command": "/path/to/dpb-mcp-go/build/dpb-mcp"
  }
}

{
  "mcpServers": {
    "dependency-buster": {
      "command": "/path/to/dpb-mcp-rust/target/release/dpb-mcp"
    }
  }
}

{
  readOnlyHint: true,      // Doesn't modify files
  idempotentHint: true,    // Same result on repeated calls
  cacheTtlSeconds: 300,    // Cache results for 5 minutes
  tags: ["analysis", "dependencies", "security"]
}

dependency-buster/
├── dpb-mcp-typescript/    # TypeScript implementation
│   ├── src/
│   │   ├── server.ts               # MCP server entry
│   │   ├── tools/                  # Analysis tools
│   │   ├── errors.ts               # Typed errors
│   │   ├── annotations.ts          # Tool annotations
│   │   └── auth.ts                 # Authentication
│   └── build/
│
├── dpb-mcp-go/          # Go implementation
│   ├── cmd/server/main.go
│   └── pkg/
│       ├── mcp/                    # MCP protocol
│       └── analyzer/               # Analysis tools
│
├── dpb-mcp-rust/        # Rust implementation
│   └── src/
│       ├── main.rs
│       ├── mcp/                    # MCP protocol
│       └── analyzer/               # Analysis tools
│
└── dpb-benchmark/              # Benchmark suite
    ├── scripts/run-benchmark.sh    # Main runner
    ├── dashboard/index.html        # Visualization
    └── results/                    # Generated reports

# Enable authentication
export MCP_AUTH_ENABLED=true
export MCP_TOKEN=your-secret-token

# Use HTTP transport
export MCP_TRANSPORT=http
export MCP_HTTP_PORT=3000

# Run server
./build/dpb-mcp

# Build and serve (opens browser automatically)
cd dpb-benchmark
make serve

# Development mode with Air hot-reload
make dev

# Install Air (first time only)
make install-air

# Check port 8080
lsof -ti:8080 && echo "Server is running" || echo "Server is not running"

# Or check process
ps aux | grep dashboard-server

@dependency-buster generate_mkdocs_docs repo_path=/path/to/repo

@dependency-buster generate_mkdocs_docs repo_path=/path/to/repo output_dir=./docs include_changelog=true format=mkdocs site_name="My Project" site_description="Project Documentation"

echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"generate_mkdocs_docs","arguments":{"repo_path":"/path/to/repo","output_dir":"./docs","include_changelog":true,"format":"mkdocs"}},"id":1}' | node dpb-mcp-typescript/build/server.js

echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"generate_mkdocs_docs","arguments":{"repo_path":"/path/to/repo","output_dir":"./docs"}},"id":1}' | ./dpb-mcp-go/build/dpb-mcp

echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"generate_mkdocs_docs","arguments":{"repo_path":"/path/to/repo","output_dir":"./docs"}},"id":1}' | ./dpb-mcp-rust/target/release/dpb-mcp

cd docs
pip install mkdocs mkdocs-material
mkdocs serve
# Opens at http://127.0.0.1:8000

# Open in your editor
code docs/index.md

# Generate with format=html
# Then open docs/index.html in browser

# Basic usage
@dependency-buster generate_mkdocs_docs repo_path=/path/to/repo

# With custom output directory
@dependency-buster generate_mkdocs_docs repo_path=/path/to/repo output_dir=./custom-docs

# Without changelog (faster)
@dependency-buster generate_mkdocs_docs repo_path=/path/to/repo include_changelog=false

# HTML format instead of MkDocs
@dependency-buster generate_mkdocs_docs repo_path=/path/to/repo format=html

- name: Generate Documentation
  run: |
    # Call generate_mkdocs_docs tool
    echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"generate_mkdocs_docs","arguments":{"repo_path":"${{ github.workspace }}"}},"id":1}' | node dpb-mcp-typescript/build/server.js
    # Commit docs/ directory to repository

name: Dependency Analysis
on: [push]

jobs:
  analyze:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          
      - name: Run dependency-buster
        run: |
          git clone https://github.com/your-username/dependency-buster.git /tmp/dpb
          cd /tmp/dpb/dpb-mcp-typescript
          npm install && npm run build
          cd $GITHUB_WORKSPACE
          /tmp/dpb/dpb-benchmark/scripts/run-benchmark.sh .
          
      - name: Upload Dashboard
        uses: actions/upload-artifact@v4
        with:
          name: dependency-report
          path: /tmp/dpb/dpb-benchmark/dashboard/index.html

# TypeScript
cd dpb-mcp-typescript
npm test

# Go
cd dpb-mcp-go
go test ./...

# Rust
cd dpb-mcp-rust
cargo test

./build-all.sh