Newline MCP Server

Newline模型上下文协议（MCP）服务器

让您的人工智能代理通过使用我们的MCP服务器与Newline Banking API进行交互。

Newline模型上下文协议（MCP）服务器提供了一套全面的工具，人工智能代理可以使用这些工具与Newline Banking API交互，以管理综合账户、转账、客户、交易和其他银行业务。

连接到Newline的MCP服务器

光标

将以下内容添加到您的 ~/.cursor/mcp.json 文件。要了解更多信息，请参阅光标 文档.

{
  "mcpServers": {
    "newline": {
      "command": "npx",
      "args": ["-y", "git+https://github.com/newline53/newline-mcp-server"],
      "env": {
        "NEWLINE_HMAC_KEY": ">",
        "NEWLINE_PROGRAM_ID": ">",
        "NEWLINE_BASE_URL": "https://sandbox.newline53.com/api/v1"
      }
    }
  }
}

代码编辑器代理会自动检测所有可用的工具，并在您在聊天中发布相关问题时调用相关工具。

VS Code

将以下内容添加到您的 .vscode/mcp.json 您工作区中的文件。要了解更多信息，请参阅VS代码 文档.

使用promptStrings-这将提示输入

{
  "inputs": [
    {
      "type": "promptString",
      "id": "hmac-key",
      "description": "Newline HMAC API key",
      "password": true
    },
    {
      "type": "promptString",
      "id": "program-id",
      "description": "Newline program ID",
      "password": true
    },
    {
      "type": "promptString",
      "id": "base-url",
      "description": "Newline API base URL",
      "default": "https://sandbox.newline53.com/api/v1"
    }
  ],
  "servers": {
    "newline": {
      "command": "npx",
      "args": ["-y", "git+https://github.com/newline53/newline-mcp-server"],
      "env": {
        "NEWLINE_HMAC_KEY": "${input:hmac-key}",
        "NEWLINE_PROGRAM_ID": "${input:program-id}",
        "NEWLINE_BASE_URL": "${input:base-url}"
      }
    }
  }
}

使用环境变量

{
  "servers": {
    "special-mcp-server": {
      "command": "npx",
      "args": ["git+https://github.com/newline53/newline-mcp-server"],
      "env": {
        "NEWLINE_HMAC_KEY": "${env:NEWLINE_HMAC_KEY}",
        "NEWLINE_PROGRAM_ID": "${env:NEWLINE_PROGRAM_ID}",
        "NEWLINE_BASE_URL": "${env:NEWLINE_BASE_URL}"
      }
    }
  }
}

帆板运动

将以下内容添加到您的 ~/.codeium/windsurf/mcp_config.json 文件。要了解更多信息，请参阅Windsurf 文档.

{
  "mcpServers": {
    "newline": {
      "command": "npx",
      "args": ["-y", "git+https://github.com/newline53/newline-mcp-server"],
      "env": {
        "NEWLINE_HMAC_KEY": ">",
        "NEWLINE_PROGRAM_ID": ">",
        "NEWLINE_BASE_URL": "https://sandbox.newline53.com/api/v1"
      }
    }
  }
}

克劳德桌面

将以下内容添加到您的 claude_desktop_config.json 文件。要了解更多信息，请参阅克劳德桌面 文档.

{
  "mcpServers": {
    "newline": {
      "command": "npx",
      "args": ["-y", "git+https://github.com/newline53/newline-mcp-server"],
      "env": {
        "NEWLINE_HMAC_KEY": ">",
        "NEWLINE_PROGRAM_ID": ">",
        "NEWLINE_BASE_URL": "https://sandbox.newline53.com/api/v1"
      }
    }
  }
}

命令行界面

使用以下命令在本地启动MCP服务器：

NEWLINE_HMAC_KEY=">" \
NEWLINE_PROGRAM_ID=">" \
NEWLINE_BASE_URL="https://sandbox.newline53.com/api/v1" \
npx -y git+https://github.com/newline53/newline-mcp-server

或全局安装：

npm install -g git+https://github.com/newline53/newline-mcp-server

# Run the server
NEWLINE_HMAC_KEY=">" \
NEWLINE_PROGRAM_ID=">" \
NEWLINE_BASE_URL="https://sandbox.newline53.com/api/v1" \
newline

配置

Newline MCP服务器需要以下环境变量：

API环境

• 沙盒: https://sandbox.newline53.com/api/v1 （默认）
• 生产：有关生产终点的详细信息，请联系Newline

安全考虑

我们强烈建议：

• 从不将凭据提交到版本控制
• 使用环境变量或安全凭据管理
• 定期旋转HMAC密钥
• 为开发和生产环境使用不同的凭据
• 使用MCP服务器时启用工具的人工确认，以避免意外操作

工具

服务器暴露35+ MCP工具 用于与Newline Banking API交互。我们建议启用人工确认工具，并在将Newline MCP与其他服务器一起使用时谨慎行事，以避免及时注入攻击。

技能

此服务器附带十个捆绑包 代理技能 在 skills/ 目录。技能是 工作流指导人工智能代理按需加载以执行常见的多步银行业务 操作正确——它们编码了正确的工具调用顺序、所需的参数， 以及每个场景的决策逻辑，因此您不必从头开始提示代理。

前六项是专注的任务技能；另外四个是更广泛、可重用的工作流 适用于通用代理技能兼容工具的技能，如Pi、Claude Code和 OpenAI Codex。

有关不同代理线束的安装和使用指南，请参阅 skills/README.md.

兼容性

技能遵循 代理技能开放标准 和 使用任何兼容的代理工具：

• π --技能 skills/ 作为一个包自动发现；不需要配置。

强制加载技能 /skill: （例如。 /skill:create-transfer).

• Claude Code/OpenAI Codex/其他工具 --将安全带指向 skills/

在设置中添加目录，或将单个技能目录复制到全局技能中 文件夹（例如。 ~/.agents/skills/).这些技能是普通的代理技能目录 不依赖于仅Pi元数据。

示例提示

一旦你的代理工具加载了技能，使用自然语言：

Create an ACH transfer of $250 from account A to account B
What happened to transfer uid_abc123?
Open a new checking account for Jane Doe
Give me a full overview of customer john@example.com
Reconcile synthetic account uid_xyz789
Why was return uid_ret456 issued and what should I do?
Walk me through setting up a customer and account for future payments
Help me trace a payment failure from the transfer to the underlying transactions
Show me the event timeline and ledger impact for transaction txn_456

代理将自动加载相关技能并逐步执行 使用MCP工具的说明。

Docker使用

您还可以在Docker容器中运行Newline MCP服务器。

构建Docker镜像

首先，从项目的根目录构建Docker镜像：

docker build -t newline-mcp-server:latest .

运行容器

然后使用您的凭据运行容器：

docker run \
  -e NEWLINE_HMAC_KEY=">" \
  -e NEWLINE_PROGRAM_ID=">" \
  -e NEWLINE_BASE_URL="https://sandbox.newline53.com/api/v1" \
  newline-mcp-server:latest

使用Docker进行MCP配置

将以下内容添加到MCP配置中：

{
  "servers": {
    "newline-docker": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "NEWLINE_HMAC_KEY=>",
        "-e", "NEWLINE_PROGRAM_ID=>",
        "-e", "NEWLINE_BASE_URL=https://sandbox.newline53.com/api/v1",
        "newline-mcp-server:latest"
      ]
    }
  }
}

示例用法

以下是一些可以与连接到Newline MCP服务器的AI助手一起使用的示例提示：

账户管理

• “列出所有可用的合成帐户类型”
• “显示我的所有合成帐户”
• “为客户John Doe创建一个新的支票账户”
• “获取ID为abc123的合成帐户的详细信息”

转移操作

• “列出所有最近的转账”
• “创建从账户a到账户B的1000美元电汇”
• “显示传输xyz789的状态”
• “列出上个月的所有ACH转账”

客户信息

• “列出所有客户”
• “查找客户详细信息john.doe@example.com"
• “显示本周创建的所有客户”

交易查询

• “列出账户abc123的所有交易”
• “显示txn_456的交易详细信息”
• “获得所有超过5000美元的交易”

资源管理

• “列出所有可用池”
• “显示所有产品”
• “获取托管帐户信息”

故障排除

身份验证错误

如果收到身份验证错误，请验证：

• 你的 NEWLINE_HMAC_KEY 正确且活跃
• 你的 NEWLINE_PROGRAM_ID 与您的Newline计划相匹配
• 您使用的是正确的 NEWLINE_BASE_URL 为了您的环境

连接问题

如果MCP服务器连接失败：

• 检查您的网络连接
• 如果需要，请验证任何代理设置(https_proxy 环境变量）
• 确保可以从您的网络访问Newline API端点

工具执行错误

如果工具无法执行：

• 验证您是否具有操作所需的权限
• 检查是否提供了所需的参数
• 查看错误消息以获取具体指导
• 确保您的API凭据可以访问请求的资源

自治代理

如果您正在构建代理软件，则可以将Newline MCP服务器集成到您的自主工作流中。服务器支持标准MCP协议，可以与以下框架一起使用：

• OpenAI的回应API
• LangChain
• 自动GPT
• 自定义代理实现

与环境变量集成的示例：

import os

mcp_config = {
    "command": "npx",
    "args": ["-y", "git+https://github.com/newline53/newline-mcp-server"],
    "env": {
        "NEWLINE_HMAC_KEY": os.getenv("NEWLINE_HMAC_KEY"),
        "NEWLINE_PROGRAM_ID": os.getenv("NEWLINE_PROGRAM_ID"),
        "NEWLINE_BASE_URL": os.getenv("NEWLINE_BASE_URL", "https://sandbox.newline53.com/api/v1")
    }
}

开发和测试

本地开发

克隆存储库并安装依赖项：

git clone https://github.com/newline53/newline-mcp-server.git
cd newline-mcp-server
npm install

构建项目：

npm run build

运行测试：

npm test

本地运行

构建后，您可以在本地运行服务器：

node dist/index.js

或者使用MCP客户端中的开发配置：

{
  "servers": {
    "newline-local": {
      "command": "node",
      "args": ["/path/to/newline-mcp-server/dist/index.js"],
      "env": {
        "NEWLINE_HMAC_KEY": ">",
        "NEWLINE_PROGRAM_ID": ">",
        "NEWLINE_BASE_URL": "https://sandbox.newline53.com/api/v1"
      }
    }
  }
}

特性

• 🔐 安全认证：基于JWT的HMAC签名身份验证
• 🏦 银行业务：账户和转账管理综合工具
• 👥 客户管理：列出并检索客户信息
• 💰 交易跟踪：访问交易数据和事件
• 📊 资源管理：管理池、产品和托管账户
• 🔄 传输类型：支持电汇、ACH和即时支付转账
• 🌐 代理支持：适用于企业环境的可配置HTTPS代理
• 📝 类型安全：完全支持TypeScript和类型定义
• ✅ 验证：使用Zod模式进行输入验证
• 🛡️ 错误处理：全面的错误处理和记录

支持

对于问题、疑问或功能请求：

• 电子邮件：VulnerabilityManagement.Bancorp@53.com
• GitHub问题：https://github.com/newline53/newline-mcp-server/issues
• 文档：https://github.com/newline53/newline-mcp-server#readme

许可证

Apache 2.0

另见

• Newline API文档
• 模型上下文协议规范
• 使用MCP构建