Marble

MCP server that analyzes codebases to generate learning project links and interactive Marble slides.

javascript

1

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "withmarbleai-marble-mcp": {
      "command": "npx",
      "args": [
        "marble-mcp-server"
      ],
      "env": {
        "SLIDES_STORAGE_KEY": "abcd1234",
        "SLIDES_STORAGE_URL": "https://storage.example/slides"
      }
    }
  }
}

The Marble MCP Server analyzes your codebase to propose learning projects and generates Marble links to create those projects on the Marble platform. It also can produce interactive learning slides based on your code, making it easier to explore concepts directly within Marble.

How to use

You use the Marble MCP Server through an MCP client to get tailored learning projects and interactive slides for your codebase. When you ask for learning projects, the server analyzes your code, suggests three project ideas at different difficulty levels, and returns Marble links you can open to create those projects. When you want visual explanations, you can request interactive slides that explain concepts with code examples and demonstrations.

How to install

Prerequisites: you need Node.js installed on your system. You also need access to an MCP-capable client to connect to the Marble MCP Server.

# Run the Marble MCP Server locally via npx (stdio)
npx marble-mcp-server
```}],},{

Configuration and usage notes

You can enable advanced features by configuring environment variables for slide generation, which may require a database and API keys. The server supports storing prompts to a database to produce shorter, shareable Marble links. If a database is not configured, prompts are encoded directly in the links.

Security and notes

Use the provided environment variables to securely enable slide generation. Do not expose secret keys in public code. The publishable key for the slide service can be rotated without downtime.

Troubleshooting

If you encounter errors when generating slides, verify that your environment variables SUPABASE_URL and SUPABASE_KEY are correctly set and that the slide_prompts table exists in your database.

Available tools

suggest_learning_projects

Instructs the MCP to analyze the codebase and propose learning projects based on a topic, code context, and difficulty.

generate_marble_link

Creates a Marble project link from a detailed project data object, including title, description, category, difficulty, time estimate, technologies, and target skills.

generate_slides_link

Generates a link to interactive learning slides on Marble using a comprehensive prompt and code examples from the codebase.