诺曼-MCP服务器

Name: 诺曼-MCP服务器
Author: norman-finance

作者：norman-finance8 星标更新：2025-06-11

安装使用来源：spider==github.com

项目介绍

<div align="center">诺曼金融 MCP 服务器</div>

此模型上下文协议（MCP）服务器使AI能够与诺曼金融API进行交互，通过标准化协议访问会计、发票、公司、客户、税务等信息。

[!NOTE]

诺曼金融 MCP 服务器目前处于测试阶段。我们欢迎您的反馈，并鼓励您通过在此处提交问题来报告任何错误。

功能

🔐 身份验证：安全地使用诺曼金融账户进行身份验证
💼 公司管理：管理您的公司详情，获取公司余额、增值税洞察等
📊 会计：监控您的交易和分类
📝 (电子)发票：制作、查看、发送和处理发票。您可以根据合同设置定期发票
👥 客户管理：创建和管理您的客户（CRM）
💰 税务：查看税务信息和报告，生成官方税务局PDF预览并申报税务
📄 文档：上传和管理附件（收据、发票、文件等）

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

</summary> <table> <tr> <td align="center"> <p><strong>提交增值税报告</strong></p> <img src="https://gips1.baidu.com/it/u=3642534106,1923992849&fm=3081&app=3081&f=GIF?w=800&h=499" alt="使用诺曼 MCP 提交增值税报告" width="400"> </td> <td align="center"> <p><strong>获取交易洞察</strong></p> <img src="https://gips0.baidu.com/it/u=3875763491,2984047299&fm=3081&app=3081&f=GIF?w=800&h=499" alt="使用诺曼 MCP 获取交易洞察" width="400"> </td> </tr> <tr> <td align="center"> <p><strong>同步 Stripe 支付到诺曼</strong></p> <img src="https://gips3.baidu.com/it/u=1532627865,759497569&fm=3081&app=3081&f=GIF?w=800&h=499" alt="同步 Stripe 支付到诺曼" width="400"> </td> <td align="center"> <p><strong>使用 Gmail 收据创建交易</strong></p> <img src="https://gips1.baidu.com/it/u=3497570837,336918528&fm=3081&app=3081&f=PNG?w=1260&h=1944" alt="使用 Gmail 收据创建交易" width="200"> </td> </tr> <tr> <td align="center"> <p><strong>管理逾期发票 - 1</strong></p> <img src="https://gips1.baidu.com/it/u=168104024,2914160411&fm=3081&app=3081&f=PNG?w=1576&h=2146" alt="管理逾期发票 - 1" width="300"> </td> <td align="center"> <p><strong>管理逾期发票 - 2</strong></p> <img src="https://github.com/user-attachments/assets/26cfb8e9-4725-48a9-b413-077dfb5902e7" alt="管理逾期发票 - 2" width="350"> </td> </tr> </table> </details>

先决条件

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

在诺曼金融上创建一个账户
准备好用于身份验证的电子邮件和密码

远程 MCP 服务器

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

https://mcp.norman.finance/sse

推荐使用远程 MCP，因为它利用了 OAuth 身份验证，允许您直接使用诺曼账户登录，无需手动创建或管理访问令牌。

安装

Cursor

要将诺曼 MCP 服务器添加到 Cursor，请将以下深度链接复制粘贴到浏览器中：

cursor://anysphere.cursor-deeplink/mcp/install?name=norman-finance-mcp&config=eyJjb21tYW5kIjoibnB4IiwidHlwZSI6InNzZSIsImFyZ3MiOlsibWNwLXJlbW90ZSIsImh0dHBzOi8vbWNwLm5vcm1hbi5maW5hbmNlL3NzZSJdfQ==

Claude.ai 集成

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

对于 Claude Max:

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

对于 Claude Enterprise & 团队:

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

启用诺曼集成:

与 Claude 开始聊天。
打开 搜索和工具菜单。
点击“连接”以链接您的诺曼账户。
<img width="400" alt="image" src="https://gips2.baidu.com/it/u=249960870,3086907910&fm=3081&app=3081&f=PNG?w=2176&h=1774" />
连接后，使用同一菜单开启特定的诺曼工具。

添加到 Claude Desktop

要在 Claude Desktop 中运行诺曼金融 MCP 服务器，可以使用上述说明或按照以下步骤手动添加：

1. 下载和配置 Claude Desktop

下载 Claude Desktop。
启动 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"
      }
    }
  }
}

配置

身份验证方法

诺曼 MCP 服务器支持两种身份验证方法：

1. OAuth 身份验证（适用于 SSE 传输）

当使用 MCP Inspector、Claude 或其他 SSE 客户端时，服务器使用 OAuth 2.0 身份验证：

使用 SSE 传输启动服务器：
```
python -m norman_mcp --transport sse
```
当连接到服务器时，您将被引导至登录页面
输入您的诺曼金融凭据
您将被重定向回应用程序并获得身份验证令牌

2. 环境变量（适用于 stdio 传输）

当使用 Claude Desktop 或 stdin/stdout 通信时，通过环境变量提供凭据：

# .env
NORMAN_EMAIL=your-email@example.com
NORMAN_PASSWORD=your-password
NORMAN_ENVIRONMENT=production  # 或 "sandbox" 用于开发环境
NORMAN_API_TIMEOUT=200  # 请求超时时间（秒）

环境变量

服务器可以通过以下环境变量进行配置：

# 身份验证（适用于 stdio 传输）
NORMAN_EMAIL=your-email@example.com
NORMAN_PASSWORD=your-password
NORMAN_ENVIRONMENT=production  # 或 "sandbox" 用于开发环境

# 服务器配置
NORMAN_MCP_HOST=0.0.0.0  # 绑定主机
NORMAN_MCP_PORT=3001     # 绑定端口
NORMAN_MCP_PUBLIC_URL=http://example.com  # OAuth 回调的公共 URL（远程访问重要）
NORMAN_API_TIMEOUT=200   # 请求超时时间（秒）

开发

本节面向希望开发或扩展诺曼金融 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"
      }
    }
  }
}

您有功能想法或想看到的内容吗？分享您的建议

<p align="center"> 让业务变得轻松 <div align="center"><img width="140px" src="https://gips3.baidu.com/it/u=1166906905,3683974983&fm=3081&app=3081&f=PNG?w=288&h=108"></div> </p>