# BaseHub MCP


This project was created with [create-xmcp-app](https://github.com/basementstudio/xmcp).
The MCP (Model Context Protocol) integration enables AI agents to interact directly with your BaseHub repository through a comprehensive set of tools. From creating and updating content blocks to managing assets and automating workflows, you can build functional websites, migrate hardcoded content, and set up forms—all through natural language prompts with your favorite AI tools.

<img width="3600" height="2025" alt="MCP Changelog, V01" src="https://github.com/user-attachments/assets/f15d5a03-3ca6-40c7-afa4-aadc2d483747" />

*This was part of our AI Week venture. [Learn more in our changelog](https://basehub.dev/changelog/ai-week-day-1-basehub-mcp)*

## How to use it

You can check the user documentation in [basehub.com/dcos/ai/mcp](https://docs.basehub.com/ai/mcp)

## Development

First, run the development server:

```bash
npm run dev
# or
yarn dev
# or
pnpm dev
```

This will start the MCP server with both SSE and STDIO transport methods.

## Project Structure

This project uses the structured approach where tools are automatically discovered from the `src/tools` directory. Each tool is defined in its own file with the following structure:

```typescript
import { z } from "zod";
import { type InferSchema } from "xmcp";

// Define the schema for tool parameters
export const schema = {
  a: z.number().describe("First number to add"),
  b: z.number().describe("Second number to add"),
};

// Define tool metadata
export const metadata = {
  name: "add",
  description: "Add two numbers together",
  annotations: {
    title: "Add Two Numbers",
    readOnlyHint: true,
    destructiveHint: false,
    idempotentHint: true,
  },
};

// Tool implementation
export default async function add({ a, b }: InferSchema<typeof schema>) {
  return {
    content: [{ type: "text", text: String(a + b) }],
  };
}
```

## Adding New Tools

To add a new tool:

1. Create a new `.ts` file in the `src/tools` directory
2. Export a `schema` object defining the tool parameters using Zod
3. Export a `metadata` object with tool information
4. Export a default function that implements the tool logic

## Building for Production

To build your project for production:

```bash
npm run build
# or
yarn build
# or
pnpm build
```

This will compile your TypeScript code and output it to the `dist` directory.

## Running in Production

To run your bundled MCP server in production:

```bash
npm run start-sse
# or
npm run start-stdio
```

## Learn More

- [XMCP Documentation](https://github.com/basementstudio/xmcp)
- [Tool Structure Documentation](src/tools/tools.md)