Norman Finance MCP Server

Official
MIT License
4
  • Linux
  • Apple
Integrations
  • Supports configuration through .env files to store and manage Norman Finance credentials and environment settings.

  • Allows importing receipts from Cloudflare into the Norman Finance system, demonstrated in the Gmail receipts example.

  • Provides access to installation from source via GitHub repository, with examples linking to attachments hosted on GitHub.

Norman Finance MCP 服务器

模型上下文协议 (MCP)服务器使 AI 能够与 Norman Finance API 交互,允许通过标准化协议访问会计、发票、公司、客户、税收等。

[!笔记]

Norman Finance MCP 服务器目前处于测试阶段。我们欢迎您的反馈,并鼓励您在此处提交问题报告。

特征

  • 🔐身份验证:使用 Norman Finance 帐户进行安全身份验证
  • 💼公司管理:管理您的公司详细信息,获取公司余额、增值税信息等
  • 📊会计:密切关注您的交易、分类
  • 📝 (电子)发票:制作、查看、发送和处理发票。您甚至可以根据合同设置定期发票
  • 👥客户管理:创建和管理您的客户(CRM)
  • 💰税务:查看税务信息和报告,生成官方 Finanzamt PDF 预览并申报税务
  • 📄文件:上传和管理附件(收据、发票、文件等)

👇 使用 Claude Desktop 的案例示例 — 切换

先决条件

使用此 MCP 服务器之前,您需要:

  1. Norman Finance上创建账户
  2. 准备好电子邮件和密码以进行身份验证

远程 MCP 服务器

Norman 现在提供托管远程 MCP 服务器:

https://mcp.norman.finance/sse

建议使用远程 MCP,因为它采用 OAuth 身份验证,使您能够直接使用 Norman 帐户登录,而无需手动创建或管理访问令牌。

安装

Claude.ai集成

将 Norman MCP 服务器添加到 Claude.ai:

对于克劳德·马克斯来说:

  1. 前往*“设置”>“个人资料”*
  2. 找到“集成”部分
  3. 点按“添加更多”
  4. 输入 Norman MCP 服务器 URL: https://mcp.norman.finance/sse
  5. 点击“添加”完成

对于 Claude 企业和团队:

  1. 转至*“设置”>“集成”* (针对团队)或*“设置”>“数据管理*”(针对企业)
  2. 找到“集成”部分
  3. 点击“添加更多”
  4. 输入 Norman MCP 服务器 URL: https://mcp.norman.finance/sse
  5. 点击“添加”完成

启用 Norman 集成:

  1. 开始与 Claude 聊天。
  2. 打开搜索和工具菜单
  3. 单击“连接”以链接您的 Norman 帐户。
  4. 连接后,使用相同的菜单打开特定的 Norman 工具。

添加到 Claude 桌面

要使用 Claude Desktop 运行 Norman Finance MCP 服务器,您可以使用上述说明或按照以下步骤手动添加:

1.下载并配置Claude Desktop
  1. 下载Claude 桌面
  2. 启动 Claude 并导航至:设置 > 开发者 > 编辑配置。
  3. 使用以下配置更新您的claude_desktop_config.json文件:
远程 MCP
{ "mcpServers": { "norman-mcp-server": { "command": "npx", "args": ["mcp-remote", "https://mcp.norman.finance/sse"] } } }
本地 MCP
安装 uv

按照此处的说明操作:安装 uv

{ "mcpServers": { "norman-mcp-server": { "command": "<home_path>/.local/bin/uvx", "args": [ "--from", "norman-mcp-server@latest", "norman-mcp" ], "env": { "NORMAN_EMAIL": "your-email@example.com", "NORMAN_PASSWORD": "your-password", "NORMAN_ENVIRONMENT": "production" } } } }

配置

身份验证方法

Norman MCP 服务器支持两种身份验证方法:

1. OAuth 身份验证(用于 SSE 传输)

当将服务器与 MCP Inspector、Claude 或其他 SSE 客户端一起使用时,服务器使用 OAuth 2.0 身份验证:

  1. 使用 SSE 传输启动服务器:
    python -m norman_mcp --transport sse
  2. 连接到服务器后,您将被引导至登录页面
  3. 输入您的 Norman Finance 凭证
  4. 您将被重定向回您的应用程序并带有身份验证令牌
2. 环境变量(用于 stdio 传输)

当使用带有 Claude Desktop 或 stdin/stdout 通信的服务器时,请通过环境变量提供凭据:

# .env NORMAN_EMAIL=your-email@example.com NORMAN_PASSWORD=your-password NORMAN_ENVIRONMENT=production # or "sandbox" for the development environment NORMAN_API_TIMEOUT=200 # Request timeout in seconds

环境变量

可以使用以下环境变量配置服务器:

# Authentication (for stdio transport) NORMAN_EMAIL=your-email@example.com NORMAN_PASSWORD=your-password NORMAN_ENVIRONMENT=production # or "sandbox" for the development environment # Server configuration NORMAN_MCP_HOST=0.0.0.0 # Host to bind to NORMAN_MCP_PORT=3001 # Port to bind to NORMAN_MCP_PUBLIC_URL=http://example.com # Public URL for OAuth callbacks (important for remote access) NORMAN_API_TIMEOUT=200 # Request timeout in seconds

发展

本节适用于想要开发或扩展 Norman Finance MCP 服务器的贡献者。

本地设置

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

然后更新您的 claude_desktop_config.json 文件以直接指向 Python 模块:

{ "mcpServers": { "norman-mcp-server": { "command": "<path_to_your_python>/python", "args": ["-m", "norman_mcp"], "env": { "NORMAN_EMAIL": "your-email@example.com", "NORMAN_PASSWORD": "your-password", "NORMAN_ENVIRONMENT": "production" } } } }

你有什么功能创意或希望看到的内容吗?分享你的建议


You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

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

Norman Finance 是一款专为德国企业家设计的会计和税务申报自动化系统。Norman Finance MCP 服务器支持与 Norman Finance 的会计、税务和发票服务进行交互的全新方式。通过集成 Norman Finance API 功能,简化财务工作流程。

  1. 特征
    1. 👇 使用 Claude Desktop 的案例示例 — 切换
  2. 先决条件
    1. 远程 MCP 服务器
      1. 安装
        1. Claude.ai集成
        2. 添加到 Claude 桌面
      2. 配置
        1. 身份验证方法
        2. 环境变量
      3. 发展
        1. 本地设置

      Related MCP Servers

      • A
        security
        A
        license
        A
        quality
        A Model Context Protocol (MCP) server that provides real-time access to financial market data through the free Alpha Vantage API. This server implements a standardized interface for retrieving stock quotes and company information.
        Last updated -
        5
        30
        Python
        MIT License
        • Apple
      • -
        security
        A
        license
        -
        quality
        An MCP server that allows accessing and managing ledger files through Claude by providing account listing, balance checking, and transaction register viewing capabilities.
        Last updated -
        1
        Python
        GPL 3.0
        • Apple
      • A
        security
        A
        license
        A
        quality
        A simple MCP server for Yahoo Finance using yfinance. This server provides a set of tools to fetch stock data, news, and other financial information.
        Last updated -
        10
        9
        Python
        MIT License
      • -
        security
        F
        license
        -
        quality
        Integrate the MCP Server for Mifos X an Open Source Core Banking Solution for Financial Institutions. Useful for managing clients, loans, savings, shares, financial transactions and generating financial reports.
        Last updated -
        7

      View all related MCP servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/norman-finance/norman-mcp-server'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server