Open-Ledger-MCP-Server

Official
by openledger

OpenLedger MCP Server

A Model Context Protocol (MCP) server implementation for the OpenLedger API. This server provides structured context to AI models according to the MCP specification.

What is OpenLedger?

OpenLedger is an embedded accounting API that consolidates your customer's financial data into your platform, creating one single source of truth. It can also be used to entirely manage a ledger through an API, making it perfect for AI agents. This MCP server allows AI assistants like Claude to interact with the OpenLedger API in a structured way.

What is MCP?

The Model Context Protocol (MCP) is a standard for providing context to AI models. It allows for structured data exchange between applications and AI models, enabling more effective and contextual AI interactions.

Learn more at modelcontextprotocol.io.

Features

  • MCP-compliant server implementation
  • Integration with OpenLedger API
  • Context-aware AI interactions for financial data
  • Support for transactions, companies, and other financial entities

Quick Start

Option 1: Local Installation

# Clone the repository git clone https://github.com/yourusername/Open-Ledger-MCP-Server.git cd Open-Ledger-MCP-Server # Install dependencies bun install # Set up environment variables cp .env.example .env # Edit .env with your configuration # Start the server bun start

Option 2: Using Docker

# Clone the repository git clone https://github.com/yourusername/Open-Ledger-MCP-Server.git cd Open-Ledger-MCP-Server # Build and run with Docker Compose docker-compose up --build # Or use the provided script ./docker-run.sh

Using with Claude

To use this MCP server with Claude, add it to your Claude configuration:

{ "mcpServers": { "openledger": { "url": "http://localhost:8080/mcp" } } }

See MCP_USAGE.md for detailed instructions on how to use this server with Claude or other AI assistants that support the Model Context Protocol.

Available Resources

The OpenLedger MCP Server provides access to the following resources:

  1. openledger://transactions - Access and manage financial transactions
  2. openledger://companies - Access and manage company information
  3. openledger://categories - Access and manage transaction categories
  4. openledger://reports - Generate financial reports

Development

# Run in development mode with hot reloading bun dev # Run tests bun test # Build for production bun run build

Project Structure

. ├── src/ │ ├── controllers/ # Request handlers │ ├── routes/ # API routes │ ├── utils/ # Utility functions │ └── index.ts # Main application entry point ├── .env.example # Example environment variables ├── docker-compose.yml # Docker Compose configuration ├── Dockerfile # Docker configuration ├── MCP_USAGE.md # Guide for using with Claude ├── package.json # Project dependencies ├── README.md # This file ├── run.sh # Script to run locally └── tsconfig.json # TypeScript configuration

Scripts

  • run.sh - A shell script to install dependencies and start the server locally
  • docker-run.sh - A shell script to build and run the server in a Docker container

License

See the LICENSE file for details.

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A Model Context Protocol (MCP) server implementation for the OpenLedger API. This server provides structured context to AI models according to the MCP specification.

  1. What is OpenLedger?
    1. What is MCP?
      1. Features
        1. Quick Start
          1. Option 1: Local Installation
          2. Option 2: Using Docker
        2. Using with Claude
          1. Available Resources
            1. Development
              1. Project Structure
                1. Scripts
                  1. License

                    Related MCP Servers

                    • -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol (MCP) server that lets you seamlessly use OpenAI's models right from Claude.
                      Last updated -
                      1
                      24
                      28
                      JavaScript
                      MIT License
                      • Apple
                    • -
                      security
                      F
                      license
                      -
                      quality
                      A Model Context Protocol server implementation that enables connection between OpenAI APIs and MCP clients for coding assistance with features like CLI interaction, web API integration, and tool-based architecture.
                      Last updated -
                      9
                      Python
                      • Linux
                      • Apple
                    • -
                      security
                      F
                      license
                      -
                      quality
                      Implements the Model Context Protocol (MCP) to provide AI models with a standardized interface for connecting to external data sources and tools like file systems, databases, or APIs.
                      Last updated -
                      16
                      Python
                      • Apple
                      • Linux
                    • -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol (MCP) server that allows AI models to safely access and interact with local file systems, enabling reading file contents, listing directories, and retrieving file metadata.
                      Last updated -
                      47
                      1
                      JavaScript
                      MIT License
                      • Linux

                    View all related MCP servers

                    ID: fyxyh3fpk8