aliases: ["Spidersan MCP Server"] tags: [agent/spidersan, type/readme]

Spidersan MCP Server

MCP Server for Spidersan - Branch coordination for AI coding agents.

MIT License

This MCP server is included under the MIT license with the rest of Spidersan.

Installation

cd mcp-server
npm install
npm run build

Claude Desktop Configuration

Add to ~/.cursor/mcp.json or Claude Desktop MCP config:

{
  "mcpServers": {
    "spidersan": {
      "command": "node",
      "args": ["/path/to/Spidersan/mcp-server/dist/server.js"]
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | welcome | ✨ START HERE - onboarding ritual with demo | | list_branches | List all registered branches (filter by status) | | check_conflicts | Check for file conflicts between active branches | | get_merge_order | Get recommended merge order based on dependencies | | register_branch | Register files you're modifying on current branch | | mark_merged | Mark a branch as merged | | mark_abandoned | Mark a branch as abandoned | | get_branch_info | Get detailed info about a branch | | start_watch | NEW! Start daemon mode - watches and auto-registers | | stop_watch | NEW! Stop the background file watcher | | list_tools | List all available tools with descriptions |

Example Usage

Check for conflicts before starting work:

Use check_conflicts to see if any other agents are working on the same files

Register your branch:

Use register_branch with files ["src/index.ts", "src/lib/utils.ts"] and description "Adding utility functions"

Get merge order:

Use get_merge_order to see the recommended order for merging branches