使用说明

项目简介

Moov TypeScript SDK 不仅是 Moov API 的官方 TypeScript 客户端 SDK，更兼具 MCP 服务器的功能。通过简单的配置，即可将此 SDK 转化为一个 MCP 服务器，把 Moov API 提供的丰富的支付、账户管理等功能以 工具 (Tools) 的形式暴露出来，供 LLM (大型语言模型) 应用调用。这意味着开发者可以利用 LLM 的自然语言理解能力，通过调用 Moov API 的工具，轻松构建智能化的金融科技应用。

主要功能点

资源 (Resources) 访问: 虽然文档中没有明确提及 Resource，但 SDK 能够访问和操作 Moov API 的各种实体，例如账户、交易等，这些可以被视为广义的“资源”。
工具 (Tools) 注册与执行: SDK 将其客户端方法（如创建账户、发起支付等）转换为 MCP 工具 (Tools)，允许 LLM 客户端通过 MCP 协议调用这些工具，执行 Moov API 的各项功能。
便捷安装与配置: 通过 npm 等包管理器即可快速安装，并提供了 Claude 和 Cursor 等 MCP 客户端的详细配置步骤，方便用户快速启动和使用 MCP 服务器。
全面的 Moov API 功能: 作为 Moov API 的官方 SDK，它涵盖了 Moov 平台提供的几乎所有 API 接口，功能非常全面，为 LLM 应用提供了丰富的金融服务能力。

安装步骤

确保 Node.js 环境: 运行 MCP 服务器需要 Node.js v20 或更高版本。请确保您的环境中已安装符合要求的 Node.js。
安装 SDK 包: 使用 npm, pnpm, bun 或 yarn 等包管理器安装 '@moovio/sdk' 包。例如使用 npm：
```
npm add @moovio/sdk
```

服务器配置

MCP 服务器需要配置在 MCP 客户端中才能使用。以下分别提供了 Claude 和 Cursor 客户端的配置示例。

** Claude 配置 (claude_desktop_config.json)**

在 'claude_desktop_config.json' 文件中，'mcpServers' 字段下添加一个新的服务器配置项 "Moov"。

{
  "mcpServers": {
    "Moov": {
      "command": "npx",
      "args": [
        "-y",
        "--package",
        "@moovio/sdk",
        "--",
        "mcp",
        "start",
        "--username",
        "YOUR_MOOV_USERNAME",  // 替换为您的 Moov API 用户名
        "--password",
        "YOUR_MOOV_PASSWORD",  // 替换为您的 Moov API 密码
        "--x-moov-version",
        "YYYY-MM-DD"         // 替换为您要使用的 Moov API 版本，例如 "2023-09-01"
      ]
    }
  }
}

** Cursor 配置 (Cursor Settings > Features > MCP Servers)**

在 Cursor 的设置中，选择 'Features > MCP Servers > Add new MCP server'，并填写以下信息：

Name: 'Moov' (服务器名称，可自定义)
Type: 'command'

Command:

npx -y --package @moovio/sdk -- mcp start --username YOUR_MOOV_USERNAME --password YOUR_MOOV_PASSWORD --x-moov-version YYYY-MM-DD

请将 'YOUR_MOOV_USERNAME', 'YOUR_MOOV_PASSWORD', 和 'YYYY-MM-DD' 替换为您的 Moov API 凭据和 API 版本。

参数说明:

'--username': 您的 Moov API 用户名。
'--password': 您的 Moov API 密码。
'--x-moov-version': 您希望使用的 Moov API 版本，格式为 'YYYY-MM-DD'。请参考 Moov API 文档获取可用的版本信息。

您可以通过运行以下命令查看更多服务器启动参数：

npx -y --package @moovio/sdk -- mcp start --help

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端（如 Claude, Cursor）中，即可选择 "Moov" MCP 服务器。LLM 应用可以通过自然语言指令，调用 Moov API 提供的各种工具，例如：

创建新的 Moov 账户
查询账户信息
发起支付
管理银行账户和银行卡

具体的工具调用方式和参数，请参考 Moov API 的官方文档以及 SDK 中提供的工具列表。通过结合 LLM 的理解和生成能力，可以实现各种智能化的金融服务应用场景。

关键词