ZMCPTools

ZMCPTools is a TypeScript MCP server that provides a comprehensive, tool-rich multi-agent orchestration platform designed to work with Claude Code. It ships with 43+ tools (including LanceDB integration for vector search) and supports advanced automation, documentation intelligence, and knowledge graph capabilities. After installation, you interact with the server via the global zmcp-tools CLI and the Claude Code MCP integration to spawn, coordinate, and monitor specialized agent teams across Backend, Frontend, Testing, and Documentation workflows. Typical usage includes running documentation scraping, project analysis, browser automation tasks, knowledge-graph operations, and foundation session optimizations, all coordinated by the underlying MCP server.

To use the tools, first ensure the MCP server is running via Node.js and accessible at the configured path. You can spawn agents and orchestrate tasks by issuing MCP commands or prompts through the Claude Code integration, which surfaces the 61 professional tools and associated capabilities. The server also maintains a persistent SQLite database for agent coordination and a LanceDB vector store for semantic search, enabling persistent memory and fast retrieval during multi-step workflows. Examples include brand/style analysis, documentation scraping, project analysis, and browser automation, all orchestrated in a structured, multi-agent fashion.

Prerequisites:

• Node.js 18+
• Claude Code CLI (Anthropic)
• npm, yarn, pnpm, or bun

Production installation (recommended):

# Install globally (recommended for WSL/Linux compatibility)
pnpm add -g zmcp-tools
# If requested, approve build scripts for native dependencies
pnpm approve-builds -g

# Then install MCP integration
zmcp-tools install

# Alternative: Direct installation (may have issues with Sharp in WSL)
npx zmcp-tools@latest install     # npm
yarn dlx zmcp-tools@latest install  # yarn
bunx zmcp-tools@latest install      # bun

This automatically:

• Installs MCP server to ~/.mcptools/server/
• Configures Claude Code with claude mcp add --scope local (current directory only)
• Sets up project permissions and CLAUDE.md integration
• Initializes SQLite database for agent coordination
• Initializes LanceDB vector database for semantic search
• Creates 61 professional MCP tools ready for use

Development installation:

# Clone and setup development environment
git clone https://github.com/zachhandley/ZMCPTools
cd ZMCPTools

# Quick automated setup
pnpm install && pnpm run install:global

# Or manual setup
pnpm install              # Install dependencies
pnpm build               # Compile TypeScript  
pnpm link --global       # Create global symlink
zmcp-tools install       # Configure MCP integration

Development features:

• Global zmcp-tools command
• Hot-reload development: pnpm dev
• TypeScript compilation: pnpm build
• Test suite: pnpm test
• Full source code access and modification

MCP Server Configuration (Node.js):

# Automatically configured during installation
claude mcp add --scope local zmcp-tools node ~/.mcptools/server/index.js

This provides the core MCP server with 43+ tools (including LanceDB), multi-agent orchestration, TypeScript type safety, and the necessary persistence and vector search capabilities.

Tips and considerations:

• The installation path ~/.mcptools/server/ is where the MCP server lives; ensure this is writable by your user.
• You must run claude mcp add --scope local after installation to register the MCP server with Claude Code.
• LanceDB is used for vector embeddings and semantic search; ensure Node.js 18+ is installed to leverage native bindings.
• If you encounter native dependency issues on WSL, consider using the Production installation path or running in a compatible Linux environment.
• The CLI and server support 61 tools; explore the provided example commands in README to leverage common workflows like Brand & Style Analysis, Documentation Scraping, and Browser Automation.
• Environment variable notes: CLAUDE_MCP_SCOPE is configured during installation to local development scope; adjust if you move to a new scope or environment.