Setup & Installation

Follow these steps to build and configure the VibeMap MCP Server on your local machine.

Prerequisites

• Node.js: Ensure you have Node.js (v18 or higher) installed.

• Git: Required to clone the repository.

• VibeMap Account: An active account at vibemap.ai.

1. Build the Server

Navigate to the mcp-server directory in your VibeMap codebase and install dependencies.

# Go to the MCP directory
cd mcp-server

# Install dependencies
npm install

# Build the TypeScript source
npm run build

The compiled output will be generated in the mcp-server/build/ folder.

---

2. Obtain a Personal Access Token

The MCP server needs to authenticate as you to access your projects.

1. Log in to your VibeMap Dashboard.

2. Navigate to Account Settings -> API Keys.

3. Click "Generate New Token".

4. Name it (e.g., "Claude Desktop").

5. Copy the token immediately (starts with vm_). You will not be able to see it again.

---

3. Configuration

The server relies on environment variables for authentication and routing.

Variable	Description	Default
VIBEMAP_API_KEY	Your VibeMap Personal Access Token (vm_...).	Required
VIBEMAP_BASE_URL	The URL of your VibeMap instance.	https://vibemap.ai

Testing via Command Line

You can verify the build and configuration by running the server manually (it uses standard input/output for MCP communication, so it will wait for commands):

VIBEMAP_API_KEY=your_key_here node build/index.js

If the server starts without crashing, it is ready for integration with your MCP host.