Tigerbeetle

🚀 MCP Tiger Beetle Server

A Model Context Protocol (MCP) server that provides TigerBeetle account management.

🚀 Quick Start

This MCP Tiger Beetle server offers a range of functionalities for TigerBeetle account management. Before you start, make sure you meet the prerequisites and follow the installation steps.

✨ Features

• Create TigerBeetle accounts with detailed configurations.
• Manage account flags and attributes.
• Use a JSON-based response format.
• Integrate with Claude Desktop.

📋 Future Development To-Do List

• Retrieve an account by ID.
• List accounts using filters.
• Create transfers.
• Retrieve a transfer by ID.
• List transfers using filters.

📦 Installation

Prerequisites

• Java 17 or higher.
• Maven 3.8.1 or higher.
• TigerBeetle server.
• Claude Desktop or other MCP clients.

Steps

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 file will be located in the target directory.

📚 Documentation

Configuration

Environment Variables

Before running the application, set the following environment variables:

export TB_ADDRESS=127.0.0.1:3001  # TigerBeetle server address

Integration with Claude Desktop

1. Open Claude Desktop and navigate to Claude / Settings / Developers, then click Edit Configuration.
2. Open the file claude_desktop_config.json using your favorite text editor.
3. Add a new MCP server configuration 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"]
    }
  }
}

🤝 Contribution

1. Fork the project.
2. Create a 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

This project is distributed under the MIT License. For more details, see LICENSE.

📞 Contact

Javier Antoniucci - javier.antoniucci@gmail.com

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