MCP from API Definition for Timefold Quickstarts

by TomCools

207 downloads
Not rated
GitHub

About

An example of an MCP server for quickstarts of Timefold

Details

Author
TomCools
Downloads
207
Categories
Developer Tools

- Simple tool endpoints for use by MCP clients
- Generated API client from OpenAPI Spec
- Barebones Quarkus setup

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP from API Definition for Timefold Quickstarts
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Add the provided JSON configuration to your MCP client (e.g., Claude desktop) using the JBang command shown in the Run Config section.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp from api definition for timefold quickstarts": {
            "Timefold-mcp-quickstarts": {
                "command": "jbang",
                "args": [
                    "be.tomcools:timefold-mcp-for-quickstarts:1.0.0-SNAPSHOT:runner"
                ]
            }
        }
    }
}

McpServers

{
    "Timefold-mcp-quickstarts": {
        "command": "jbang",
        "args": [
            "be.tomcools:timefold-mcp-for-quickstarts:1.0.0-SNAPSHOT:runner"
        ]
    }
}

MCP from API Definition for Timefold Quickstarts

This repository contains the code for an MCP server which allows you to modify certain aspects of the Timefold Quickstarts.

> [!NOTE]
> This repository doesn't work with the default quickstarts of Timefold, they require a special branch.
> Consider this more as a project for inspiration.

Architecture

I have chosen to use a barebones setup using Quarkus:

- Some simple Tool endpoints, these can be used by an MCP Client (like Claude desktop or Goose).
- A generated API client from the OpenAPI Spec.

Run Config

Add this configuration to the Claude Configuration, it will use JBang to run the application.

{
  "mcpServers": {
    "Timefold-mcp-quickstarts": {
      "command": "jbang",
      "args": [
        "be.tomcools:timefold-mcp-for-quickstarts:1.0.0-SNAPSHOT:runner"
      ]
    }
  }
}
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.