Norman Finance MCP 服务器

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

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

特征

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

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

Related MCP server: Nornir MCP Server

先决条件

使用此 MCP 服务器之前，您需要：

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

远程 MCP 服务器

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

https://mcp.norman.finance/sse

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

安装

Claude.ai集成

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

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

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

对于 Claude 企业和团队：

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

启用 Norman 集成：

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

添加到 Claude 桌面

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

1.下载并配置Claude Desktop

下载Claude 桌面。
启动 Claude 并导航至：设置 > 开发者 > 编辑配置。
使用以下配置更新您的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 身份验证：

使用 SSE 传输启动服务器：
python -m norman_mcp --transport sse
连接到服务器后，您将被引导至登录页面
输入您的 Norman Finance 凭证
您将被重定向回您的应用程序并带有身份验证令牌

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" } } } }

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