MCP Craftgate Projesi

MCP Craftgate 项目

项目是什么？

本项目是一个与 Craftgate 支付基础设施集成的 MCP（模型上下文协议）服务。也就是说，它提供了一个用于查询、报告和管理支付交易的接口。本项目使用 Spring Boot 编写，并连接 Craftgate API 来处理支付数据。

简而言之：

• 用于查询和报告通过 Craftgate 完成的支付。
• 作为服务运行，处理外部发来的请求。
• 兼容 MCP 协议。

项目结构

• src/main/java/：Java 源代码所在位置。
• src/main/resources/application.properties：配置文件（API 密钥保存在此处）。
• build.gradle：项目的依赖项和构建设置。
• build/libs/：构建生成的 JAR 文件所在位置。

要求

• Java 17 或更高版本
• Gradle（或项目自带的 gradlew 脚本）
• 互联网连接（用于下载依赖项）

分步安装和运行

1. 下载源代码

将项目克隆或下载到一个文件夹中。

2. 设置 API 密钥

在 src/main/resources/application.properties 文件中，你会看到以下几行：

craftgate.api-key=dummy-api-key
craftgate.secret-key=dummy-secret-key
craftgate.base-url=https://sandbox-api.craftgate.io

如果要使用真实密钥，应将 dummy-api-key 和 dummy-secret-key 替换为自己的 Craftgate API 密钥。（测试时可以保留 dummy 值。）

3. 创建 JAR 文件

打开终端并进入项目文件夹，然后运行以下命令：

./gradlew clean build

• 如果使用 Windows：gradlew.bat clean build
• 此命令会构建项目并生成可运行的 JAR 文件。

生成的 JAR 文件位于以下文件夹中：

build/libs/mcp_craftgate-0.0.1-SNAPSHOT.jar

4. 运行 JAR 文件

可以在终端中使用以下命令：

java -jar build/libs/mcp_craftgate-0.0.1-SNAPSHOT.jar

此命令会启动 MCP Craftgate 服务。

5. MCP 配置文件应如何设置？

要在 MCP 环境中使用此 JAR 文件，应按如下方式设置配置文件。请特别留意 command 和 args 字段：

"craftgate-mcp": {
  "command": "java",
  "args": [
    "-Dspring.ai.mcp.server.stdio=true",
    "-jar",
    "/tam/yol/build/libs/mcp_craftgate-0.0.1-SNAPSHOT.jar"
  ]
}

• command：要运行的主命令（此处为 java）。
• args：传递给命令的参数。
  • -Dspring.ai.mcp.server.stdio=true 参数是兼容 MCP 运行所必需的。
  • -jar 后面必须填写 JAR 文件的完整路径。
• 需要将 /tam/yol/ 替换为你电脑上的实际目录。

使用此配置后，Craftgate 工具会在 MCP 环境中自动启动并可供使用。

6. 检查服务是否正在运行

服务启动后，如果日志中没有错误且没有发生端口冲突，就可以在 MCP 环境中使用此工具。

---

常见问题

问：从哪里获取 API 密钥？
答：可以从 Craftgate 控制面板或管理员处获取。

问：如果将 JAR 文件移到其他位置，会怎样？
答：应根据新位置更新 MCP 配置文件中的 JAR 路径。

问：依赖项会自动下载吗？
答：会，Gradle 会在首次构建时自动下载所有依赖项。

---

其他信息

• 本项目使用 Spring Boot 编写，因此运行方式与传统 Java 应用相同。
• 可以使用 ./gradlew test 命令运行测试。
• 日志会写入 model-context-protocol/craftgate/starter-stdio-server/target/mcp-craftgate-stdio-server.log 文件。

---

按照所有步骤操作，即可创建项目的 JAR 文件并在 MCP 环境中使用。如果遇到问题，可以逐步重新检查，或寻求帮助！