这是Fakturoid API的全面模型上下文协议（MCP）服务器实现，使AI模型能够通过丰富的工具、资源和引导工作流程与会计和开具发票数据交互。

概述

该MCP服务器与Fakturoid API v3完全集成，通过实现MCP的三大核心功能，充分展示了模型上下文协议的全部潜力：

• ** 🔧 工具** - 18+交互式函数，用于对Fakturoid数据执行操作
• ** 📚 资源** - 10个提供实时业务洞察的上下文数据源
• ** 💡 提示词** - 6个针对常见会计任务的专业工作流程模板

👉 托管部署： 该服务器通过 Cloudflare Workers 公开访问地址为 https://fakturoid-mcp.cookielab.ai。 使用MCP HTTP传输模式时，你可以直接连接到该端点

特色

工具（交互功能）

该服务器实现了 Fakturoid API 的全面覆盖：

• 账户管理 - 获取和更新账户信息，包括通过切换Change the Active Fakturoid Account工具实现多账户支持。

Fakturoid MCP Server

A comprehensive Model Context Protocol (MCP) server implementation for the Fakturoid API, enabling AI models to interact with accounting and invoicing data through a rich set of tools, resources, and guided workflows.

Overview

This MCP server provides a complete integration with Fakturoid API v3, demonstrating the full potential of the Model Context Protocol by implementing all three core MCP features:

• 🔧 Tools - 18+ interactive functions for performing actions on Fakturoid data
• 📚 Resources - 10 contextual data sources providing real-time business insights
• 💡 Prompts - 6 professional workflow templates for common accounting tasks

👉 Hosted deployment: The server is publicly available at https://fakturoid-mcp.cookielab.ai via Cloudflare Workers. You can connect directly to this endpoint when using the MCP HTTP transport mode

Features

Tools (Interactive Functions)

The server implements comprehensive coverage of the Fakturoid API:

• Account Management - Get and update account information, including multi-account support via switching using the Change the Active Fakturoid Account tool
• Invoice Operations - Full CRUD operations, search, filtering, and PDF generation
• Expense Tracking - Create, read, update, delete, and categorize expenses
• Contact Management - Manage subjects (companies and individuals)
• Payment Processing - Track and manage invoice and expense payments
• Document Management - Upload and manage files through inbox
• Advanced Features - Recurring generators, inventory management, webhooks

Resources (Contextual Data)

Real-time business context through custom fakturoid:// URI scheme:

• fakturoid://account - Account information and settings
• fakturoid://dashboard/summary - Financial overview and key metrics
• fakturoid://invoices/recent - Latest 20 invoices
• fakturoid://invoices/open - All unpaid invoices
• fakturoid://invoices/overdue - Overdue invoices requiring attention
• fakturoid://expenses/recent - Recent business expenses
• fakturoid://expenses/open - Unpaid expenses
• fakturoid://subjects/recent - Recently added contacts
• fakturoid://subjects/customers - Customer contacts
• fakturoid://subjects/suppliers - Supplier contacts

Prompts (Workflow Templates)

Professional templates for common accounting workflows:

• create_invoice - Guided invoice creation with best practices
• expense_categorization - Tax-compliant expense handling
• payment_followup - Professional payment reminder communications
• monthly_summary - Comprehensive financial reporting
• tax_preparation - Tax documentation organization
• client_analysis - Customer relationship and profitability analysis

Installation

Prerequisites

• Node.js 24.2.0 (see .node-version)
• pnpm package manager
• Fakturoid API credentials

Setup

1. Clone the repository:

   git clone