buxfer-mcp-server by distractdiverge - MCP Server

The Buxfer MCP Server is a robust implementation designed to facilitate seamless integration with the Buxfer API. It is built using TypeScript, ensuring strong type definitions and a more reliable codebase. The server acts as a proxy, forwarding requests to the Buxfer API while providing secure authentication mechanisms. This setup allows users to interact with various Buxfer API endpoints, such as managing transactions, accounts, loans, and more. By leveraging the MCP protocol, the server ensures that communication between clients and the Buxfer API is efficient and secure. The server is designed to be easily configurable, with credentials stored securely in environment variables, and it supports CORS to allow cross-origin requests. This makes it a versatile tool for developers looking to integrate financial data management into their applications.

Features

MCP server implementation for Buxfer API
Secure authentication
Proxy for Buxfer API endpoints
TypeScript support with proper type definitions
CORS enabled with proper configuration

Usages

local development

javascript
// Start the server in development mode
npm run dev

api usage

javascript
// Login
await fetch('http://localhost:3000/mcp', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    method: 'POST',
    path: '/api/login',
    params: {
      email: 'your-email@example.com',
      password: 'your-password'
    }
  })
});

const { data: { token } } = await loginResponse.json();

// Get transactions
const transactionsResponse = await fetch('http://localhost:3000/mcp', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    method: 'GET',
    path: '/transactions',
    params: {
      token: 'your-token',
      description: 'Grocery Shopping',
      amount: '50.00',
      accountId: '123',
      date: '2025-06-11',
      type: 'expense',
      status: 'cleared'
    }
  })
});