mcp-project-helper

A lightweight, extensible MCP (Model Context Protocol) server for running prompt-based tools and file utilities. Designed for easy integration, testing, and extension with custom prompts.

Features

• Prompt-based tools: Easily add new tools by writing simple JSON prompt files.
• File utilities: Includes tools for reading, writing, moving, and deleting files and directories.
• Custom prompts: Place your own prompt definitions in the `custom_prompts/` directory.
• Multiple transports: Supports STDIO, SSE, and HTTP for flexible integration.
• Extensive tests: Includes a test script to verify all tool endpoints.

Getting Started

Build Locally

make build-local

⚡ Quick Start

Install via go install

To quickly install the latest version from the repository:

go install github.com/ad/mcp-project-helper@latest

The binary will appear in `$GOBIN` or `$HOME/go/bin` (make sure this path is in your `$PATH`).

1. Build from source

# Clone the repository
git clone https://github.com/ad/mcp-project-helper.git
cd mcp-project-helper

go mod tidy

# Local build
make build-local

# Or manually
go build -o mcp-project-helper main.go

# Local build
make build-local

# Or manually
go build -o mcp-project-helper main.go

# Docker build
make build

Run the Server

• STDIO (default):

./mcp-project-helper

• SSE:

./mcp-project-helper -transport sse -port 8080

• HTTP:

./mcp-project-helper -transport http -port 8080

Run Tests

./test.sh

🔌 Integration

VS Code

go install github.com/ad/mcp-project-helper@latest

Добавьте в `settings.json`:

{
  "mcp": {
    "servers": {
      "helper": {
        "type": "stdio",
        "command": "/absolute/path/to/project-helper",
        "args": ["-transport", "stdio"]
      }
    }
  }
}

Docker (VS Code)

{
  "mcp": {
    "servers": {
      "helper": {
        "type": "stdio",
        "command": "docker",
        "args": [
          "run", "--rm", "-i",
          "danielapatin/mcp-project-helper:latest",
          "-transport", "stdio"
        ]
      }
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "helper": {
      "command": "/absolute/path/to/mcp-project-helper",
      "args": ["-transport", "stdio"]
    }
  }
}

Adding Custom Tools

1. Create a JSON file in `custom_prompts/` (see `palette.json` for an example).

2. Each tool must define a `description` and a `prompt` field.

3. The tool will be automatically registered and available via the MCP protocol.

Example Tools

• tool-generator: Generates a tool description and prompt template based on a user query.
• palette: Suggests a harmonious color palette for a given color.

Project Structure

• `main.go` — Main server entry point
• `prompts/` — Built-in prompt tools
• `custom_prompts/` — User-defined prompt tools
• `test.sh` — End-to-end test script
• `Makefile` — Build and run commands

License

MIT