Norman FinanceMCP Server

Norman FinanceMCP Server

site icon
2025.04.17 0
Python财务服务API集成企业工具金融服务
Norman Finance MCP Server 是一个模型上下文协议(MCP)服务器,允许大型语言模型(LLMs)与Norman Finance的基本API实现进行交互。该服务器通过标准化协议提供对会计、发票、公司、客户、税务等功能的访问。
View on GitHub

Overview

基本能力

产品定位

Norman Finance MCP Server 是一个金融服务工具,专门为大型语言模型(LLMs)提供与Norman Finance API交互的能力,涵盖会计、发票管理、客户管理等多个财务相关功能。

核心功能

  • 认证:安全地与Norman Finance API进行认证
  • 公司管理:查看和更新公司详细信息
  • 会计:访问和管理交易
  • 发票管理:创建、查看、发送和管理投诉发票
  • 客户管理:创建和管理客户
  • 税务:查看税务信息和报告,生成官方Finanzamt PDF预览
  • 文档管理:上传和管理附件

适用场景

  • 自动化财务流程
  • 集成到LLMs中以提供财务数据查询和操作
  • 企业财务管理工具

工具列表

  • 公司管理工具:获取公司详情、更新公司信息、获取公司余额等
  • 交易管理工具:搜索交易、创建交易、更新交易等
  • 发票管理工具:创建发票、获取发票详情、发送发票等
  • 客户管理工具:列出客户、获取客户详情、创建和更新客户等
  • 文档管理工具:批量上传附件、列出附件、创建附件等
  • 税务管理工具:列出税务报告、获取税务报告、验证税号等

常见问题解答

  • 如何认证?通过环境变量或命令行参数提供Norman Finance的邮箱和密码
  • 如何安装?可以通过PyPI或从源代码安装
  • 如何配置?通过.env文件或命令行参数配置

使用教程

使用依赖

  1. Norman Financedev.norman.finance(沙盒环境)创建账户
  2. 准备好邮箱和密码用于认证

安装教程

从PyPI安装(推荐)

pip install norman-mcp-server

从源代码安装

git clone https://github.com/norman-finance/norman-mcp-server.git
cd norman-mcp-server
pip install -e .

调试方式

启动MCP服务器

norman-mcp

直接执行

python -m norman_mcp

开发模式

mcp dev norman_mcp/server.py

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。