TigerBeetle

by jantoniucci

Not rated
GitHub

About

Integrates with TigerBeetle to enable creating and configuring high-performance accounting database accounts through a Spring Boot server with stdio-based connections.

Details

Author
jantoniucci
Repository
jantoniucci/mcp-tiggerbeetle
Categories
Design, AI, Database, Frontend, Infrastructure

- Create TigerBeetle accounts with detailed configuration
- Manage account flags and properties
- JSON-based response format
- Integration with Claude desktop

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 TigerBeetle
    Command (node, npx, python, etc.) [ABSOLUTE PATH TO]/java/current/bin/java
    Arguments
    • Argument 1 -Dspring.ai.mcp.server.stdio=true
    • Argument 2 -jar
    • Argument 3 [ABSOLUTE PATH TO]/mcp-tiggerbeetle/target/mcp-tiggerbeetle-0.0.1-SNAPSHOT.jar
    Environment
    • TB_ADDRESS 127.0.0.1:3001

    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

Set the following environment variables before running the application:

export TB_ADDRESS=127.0.0.1:3001  # TigerBeetle server address

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "tigerbeetle": {
            "command": "[ABSOLUTE PATH TO]/java/current/bin/java",
            "args": [
                "-Dspring.ai.mcp.server.stdio=true",
                "-jar",
                "[ABSOLUTE PATH TO]/mcp-tiggerbeetle/target/mcp-tiggerbeetle-0.0.1-SNAPSHOT.jar"
            ],
            "env": {
                "TB_ADDRESS": "127.0.0.1:3001"
            }
        }
    }
}

Macos

{
    "command": "[ABSOLUTE PATH TO]/java/current/bin/java",
    "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-jar",
        "[ABSOLUTE PATH TO]/mcp-tiggerbeetle/target/mcp-tiggerbeetle-0.0.1-SNAPSHOT.jar"
    ],
    "env": {
        "TB_ADDRESS": "127.0.0.1:3001"
    }
}

Windows

{
    "command": "[ABSOLUTE PATH TO]/java/current/bin/java",
    "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-jar",
        "[ABSOLUTE PATH TO]/mcp-tiggerbeetle/target/mcp-tiggerbeetle-0.0.1-SNAPSHOT.jar"
    ],
    "env": {
        "TB_ADDRESS": "127.0.0.1:3001"
    }
}

Linux

{
    "command": "[ABSOLUTE PATH TO]/java/current/bin/java",
    "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-jar",
        "[ABSOLUTE PATH TO]/mcp-tiggerbeetle/target/mcp-tiggerbeetle-0.0.1-SNAPSHOT.jar"
    ],
    "env": {
        "TB_ADDRESS": "127.0.0.1:3001"
    }
}

MCP TiggerBeetle Server

A Model Context Protocol Server providing TigerBeetle account management.

Features

- Create TigerBeetle accounts with detailed configuration
- Manage account flags and properties
- JSON-based response format
- Integration with Claude desktop

Backlog for Future Development

- Get Account by ID
- List Accounts by using filters
- Create transfer
- Get transfer by ID
- List transfers by using filters

Prerequisites

- Java 17 or higher
- Maven 3.8.1 or higher
- TigerBeetle server
- Claude desktop or any other MCP client

Installation

1. Clone the repository:

   git clone https://github.com/your-username/mcp-tiggerbeetle.git
cd mcp-tiggerbeetle

2. Build the project:

   mvn clean package

3. The built JAR will be located in the target directory.

Configuration

Environment Variables

Set the following environment variables before running the application:

export TB_ADDRESS=127.0.0.1:3001  # TigerBeetle server address

Integration with Claude Desktop

1. Open Claude Desktop and navigate to Claude / Settings / Developer and click on Edit Config
2. Open the file claude_desktop_config.json by using your favourite text editor
3. Add a new MCP Server configuration to the file in the mcpServers section as follows:

{
"mcpServers": {
"mcp-tiggerbeetle": {
"command": "[ABSOLUTE PATH TO]/java/current/bin/java",
"args": [
"-Dspring.ai.mcp.server.stdio=true",
"-jar",
"[ABSOLUTE PATH TO]/mcp-tiggerbeetle/target/mcp-tiggerbeetle-0.0.1-SNAPSHOT.jar"
],
"autoApprove": ["mcp-tiggerbeetle"]
}
}
}

Contributing

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Javier Antoniucci - javier.antoniucci@gmail.com

Project Link: https://github.com/jantoniucci/mcp-tiggerbeetle

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.