Open-Ledger-MCP-Server

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:

openledger://transactions - Access and manage financial transactions
openledger://companies - Access and manage company information
openledger://categories - Access and manage transaction categories
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.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP OpenAI Server
mzxrai
-
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
OpenAI MCP Server
arthurcolle
-
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 -
28
Python
MCP Server
GobinFan
-
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 -
90
Python
MCP Local File Reader
sworddut
-
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

View all related MCP servers

Appeared in Searches

Information about Puppeteer (Node.js library or related topics)

Open-Ledger-MCP-Server