feat: docs mcp server, vapi mcp command

Author: goosewin

Makefile

@@ -8,6 +8,11 @@ GOTEST=$(GOCMD) test
 GOGET=$(GOCMD) get
 GOMOD=$(GOCMD) mod
 
+# Node.js parameters for MCP server
+NPM=npm
+MCP_DIR=mcp-docs-server
+MCP_DIST=$(MCP_DIR)/dist
+
 # Binary details
 BINARY_NAME=vapi
 BUILD_DIR=build
@@ -21,20 +26,56 @@ GIT_COMMIT=$(shell git rev-parse --short HEAD 2>/dev/null || echo "unknown")
 # Build flags - note the lowercase variable names to match main.go
 LDFLAGS=-ldflags "-X main.version=$(VERSION) -X main.commit=$(GIT_COMMIT) -X main.date=$(BUILD_TIME) -X main.builtBy=make"
 
-# Default target
-all: test build
+# Default target - build both CLI and MCP server
+all: test build build-mcp
 
 # Create build directory
 $(BUILD_DIR):
 	@mkdir -p $(BUILD_DIR)
 
-# Build the binary
+# Build the CLI binary
 build: $(BUILD_DIR)
 	@echo "Building $(BINARY_NAME)..."
 	$(GOBUILD) $(LDFLAGS) -o $(BINARY_PATH) -v
 
+# Build MCP server
+build-mcp:
+	@echo "Building MCP docs server..."
+	@if [ ! -d "$(MCP_DIR)/node_modules" ]; then \
+		echo "Installing MCP server dependencies..."; \
+		cd $(MCP_DIR) && $(NPM) install; \
+	fi
+	@cd $(MCP_DIR) && $(NPM) run build
+	@echo "✅ MCP server built successfully"
+
+# Install MCP server dependencies
+mcp-deps:
+	@echo "Installing MCP server dependencies..."
+	@cd $(MCP_DIR) && $(NPM) install
+
+# Clean MCP server
+clean-mcp:
+	@echo "Cleaning MCP server..."
+	@rm -rf $(MCP_DIR)/dist
+	@rm -rf $(MCP_DIR)/node_modules
+
+# Test MCP server
+test-mcp:
+	@echo "Testing MCP server..."
+	@cd $(MCP_DIR) && $(NPM) test
+
+# Lint MCP server
+lint-mcp:
+	@echo "Linting MCP server..."
+	@cd $(MCP_DIR) && $(NPM) run lint
+
+# Publish MCP server to npm
+publish-mcp:
+	@echo "Publishing MCP server to npm..."
+	@cd $(MCP_DIR) && $(NPM) publish
+
 # Build for all platforms
-build-all: $(BUILD_DIR)
+build-all: $(BUILD_DIR) build-mcp
 	@echo "Building for all platforms..."
 	# macOS AMD64
 	GOOS=darwin GOARCH=amd64 $(GOBUILD) $(LDFLAGS) -o $(BUILD_DIR)/$(BINARY_NAME)-darwin-amd64
@@ -50,6 +91,9 @@ test:
 	@echo "Running tests..."
 	$(GOTEST) -v ./...
 
+# Run all tests (CLI + MCP server)
+test-all: test test-mcp
+
 # Run tests with coverage
 test-coverage:
 	@echo "Running tests with coverage..."
@@ -63,6 +107,9 @@ clean:
 	rm -rf $(BUILD_DIR)
 	rm -f coverage.out coverage.html
 
+# Clean everything (CLI + MCP server)
+clean-all: clean clean-mcp
+
 # Run go mod tidy
 tidy:
 	@echo "Tidying modules..."
@@ -73,18 +120,33 @@ deps:
 	@echo "Downloading dependencies..."
 	$(GOMOD) download
 
+# Install all dependencies (CLI + MCP server)
+deps-all: deps mcp-deps
+
 # Run linters
 lint:
 	@echo "Running linters..."
 	golangci-lint run
 
+# Run all linters (CLI + MCP server)
+lint-all: lint lint-mcp
+
 # Install the binary locally
 install: build
 	@echo "Installing $(BINARY_NAME)..."
 	@mkdir -p $(HOME)/.local/bin
 	@cp $(BINARY_PATH) $(HOME)/.local/bin/
 	@echo "Installed to $(HOME)/.local/bin/$(BINARY_NAME)"
 
+# Install MCP server globally
+install-mcp: build-mcp
+	@echo "Installing MCP server globally..."
+	@cd $(MCP_DIR) && $(NPM) install -g .
+	@echo "✅ MCP server installed globally"
+
+# Install everything
+install-all: install install-mcp
+
 # Run the binary
 run: build
 	$(BINARY_PATH)
@@ -114,22 +176,43 @@ version-bump-patch:
 
 # Help target to show available commands
 help:
-	@echo "Available targets:"
+	@echo "🚀 Vapi CLI & MCP Server Build System"
+	@echo ""
+	@echo "📦 CLI Commands:"
 	@echo "  build              Build the CLI binary"
 	@echo "  install            Install the CLI to ~/.local/bin"
-	@echo "  test               Run all tests"
-	@echo "  lint               Run linters"
-	@echo "  clean              Clean build artifacts"
+	@echo "  test               Run CLI tests"
+	@echo "  lint               Run CLI linters"
+	@echo "  clean              Clean CLI build artifacts"
+	@echo ""
+	@echo "🔧 MCP Server Commands:"
+	@echo "  build-mcp          Build the MCP docs server"
+	@echo "  install-mcp        Install MCP server globally"
+	@echo "  test-mcp           Run MCP server tests"
+	@echo "  lint-mcp           Run MCP server linters" 
+	@echo "  clean-mcp          Clean MCP server artifacts"
+	@echo "  publish-mcp        Publish MCP server to npm"
+	@echo ""
+	@echo "🎯 Combined Commands:"
+	@echo "  all                Build both CLI and MCP server"
+	@echo "  build-all          Build CLI for all platforms + MCP server"
+	@echo "  test-all           Run all tests (CLI + MCP server)"
+	@echo "  lint-all           Run all linters (CLI + MCP server)"
+	@echo "  clean-all          Clean everything"
+	@echo "  deps-all           Install all dependencies"
+	@echo "  install-all        Install CLI and MCP server"
 	@echo ""
-	@echo "Version management:"
+	@echo "📋 Version management:"
 	@echo "  version            Show current version"
 	@echo "  version-set        Set version (requires VERSION=x.y.z)"
 	@echo "  version-bump-major Bump major version (1.2.3 -> 2.0.0)"
 	@echo "  version-bump-minor Bump minor version (1.2.3 -> 1.3.0)"
 	@echo "  version-bump-patch Bump patch version (1.2.3 -> 1.2.4)"
 	@echo ""
 	@echo "Examples:"
+	@echo "  make all                    # Build everything"
+	@echo "  make install-all            # Install CLI + MCP server"
 	@echo "  make version-set VERSION=1.2.3"
-	@echo "  make version-bump-patch"
+	@echo "  make publish-mcp            # Publish MCP server to npm"
 
-.PHONY: all build build-all test test-coverage clean tidy deps lint install run help 
+.PHONY: all build build-mcp build-all test test-mcp test-all test-coverage clean clean-mcp clean-all tidy deps mcp-deps deps-all lint lint-mcp lint-all install install-mcp install-all run publish-mcp help 

README.md

@@ -192,6 +192,45 @@ The `init` command will:
 - Generate example code and components
 - Create environment configuration templates
 
+### MCP Integration - Turn Your IDE into a Vapi Expert
+
+Set up Model Context Protocol (MCP) integration to give your IDE's AI assistant complete knowledge about Vapi:
+
+```bash
+# Auto-detect and configure all IDEs
+vapi mcp setup
+
+# Configure a specific IDE
+vapi mcp setup cursor   # For Cursor
+vapi mcp setup windsurf # For Windsurf
+vapi mcp setup vscode   # For VSCode
+
+# Check configuration status
+vapi mcp status
+```
+
+Once configured, your IDE's AI assistant will have access to:
+
+- **Complete Vapi Documentation** - No more hallucinated API info
+- **Code Examples & Templates** - Real working examples
+- **Best Practices & Guides** - Expert-level implementation patterns
+- **Latest Features** - Always up-to-date with new releases
+
+**Supported IDEs:**
+
+- [Cursor](https://cursor.sh) - AI-powered code editor
+- [Windsurf](https://codeium.com/windsurf) - Codeium's AI IDE
+- [VSCode](https://code.visualstudio.com) - With GitHub Copilot
+
+**What this does:**
+
+- Configures your IDE to use the Vapi MCP docs server
+- Creates appropriate configuration files (`.cursor/mcp.json`, etc.)
+- Eliminates AI hallucination about Vapi features and APIs
+- Enables intelligent code suggestions specific to Vapi
+
+Try asking your IDE's AI: _"How do I create a voice assistant with Vapi?"_ and watch it provide accurate, up-to-date information!
+
 ### Configuration
 
 ```bash
@@ -422,35 +461,75 @@ The CLI will automatically check for updates periodically and notify you when a
 
 ## Project Structure
 
+This is a **monorepo** containing both the Go CLI and the TypeScript MCP server:
+
 ```
-cli/
-├── cmd/                    # Command implementations
-│   ├── root.go            # Main CLI setup
-│   ├── assistant.go       # Assistant commands
-│   ├── workflow.go        # Workflow commands
-│   ├── campaign.go        # Campaign commands
-│   ├── call.go           # Call commands
-│   ├── config.go         # Configuration commands
-│   ├── init.go           # Project initialization
-│   └── login.go          # Authentication
-├── pkg/                   # Core packages
-│   ├── auth/             # Authentication logic
-│   ├── client/           # Vapi API client
-│   ├── config/           # Configuration management
-│   ├── integrations/     # Framework integrations
-│   └── output/           # Output formatting
-├── build/                # Build artifacts (git-ignored)
-├── main.go              # Entry point
-├── Makefile             # Build automation
-└── README.md            # This file
+vapi-cli/                          # 🏠 Main repository
+├── cmd/                           # Go CLI command implementations
+│   ├── root.go                   # Main CLI setup & auth
+│   ├── assistant.go              # Assistant management
+│   ├── workflow.go               # Workflow commands
+│   ├── campaign.go               # Campaign management
+│   ├── call.go                   # Call operations
+│   ├── config.go                 # Configuration
+│   ├── init.go                   # Project integration
+│   ├── mcp.go                    # MCP server setup ✨
+│   └── login.go                  # Authentication
+├── pkg/                          # Go core packages
+│   ├── auth/                     # Authentication logic
+│   ├── client/                   # Vapi API client
+│   ├── config/                   # Configuration management
+│   ├── integrations/             # Framework detection
+│   └── output/                   # Output formatting
+├── mcp-docs-server/              # 📦 MCP Server (TypeScript)
+│   ├── src/                      # TypeScript source
+│   │   ├── index.ts              # MCP server entry point
+│   │   ├── server.ts             # Core server logic
+│   │   ├── tools/                # MCP tools (5 tools)
+│   │   ├── resources/            # MCP resources
+│   │   └── utils/                # Utilities & data
+│   ├── dist/                     # Built JavaScript
+│   ├── package.json              # npm package config
+│   └── README.md                 # MCP server docs
+├── build/                        # Build artifacts (git-ignored)
+├── main.go                       # Go CLI entry point
+├── Makefile                      # Unified build system ⚡
+└── README.md                     # This file
 ```
 
+### Monorepo Benefits
+
+- **🔄 Synchronized Development** - CLI and MCP server stay in sync
+- **📦 Single Source of Truth** - All Vapi tooling in one place
+- **🚀 Unified Build System** - `make all` builds everything
+- **🎯 Consistent Versioning** - CLI and MCP server versions aligned
+
 ## Development
 
+This monorepo includes both Go (CLI) and TypeScript (MCP server) components. The unified Makefile handles both.
+
+### Quick Start
+
+```bash
+# Build everything (CLI + MCP server)
+make all
+
+# Install everything locally
+make install-all
+
+# Test everything
+make test-all
+
+# Clean everything
+make clean-all
+```
+
 ### Building
 
+#### CLI (Go)
+
 ```bash
-# Build for current platform
+# Build CLI only
 make build
 
 # Build for all platforms
@@ -460,6 +539,34 @@ make build-all
 go run main.go
 ```
 
+#### MCP Server (TypeScript)
+
+```bash
+# Build MCP server only
+make build-mcp
+
+# Install MCP server globally
+make install-mcp
+
+# Publish to npm
+make publish-mcp
+```
+
+### Development Requirements
+
+- **Go 1.21+** - [Install Go](https://golang.org/doc/install)
+- **Node.js 18+** - [Install Node.js](https://nodejs.org/)
+- **golangci-lint** - For Go code linting
+- **npm** - For MCP server dependencies
+
+```bash
+# macOS
+brew install go node golangci-lint
+
+# Install dependencies for both projects
+make deps-all
+```
+
 ### Testing
 
 ```bash