Razorpay-MCP-Server 项目启动与配置教程

1. 项目目录结构及介绍

Razorpay-MCP-Server 项目的目录结构如下：

razorpay-mcp-server/
├── .gitignore          # 忽略文件列表
├── .editorconfig       # 编辑器配置文件
├── .env.example        # 环境变量示例文件
├── Dockerfile          # Docker 构建文件
├── docker-compose.yml  # Docker Compose 配置文件
├── package.json        # Node.js 项目依赖文件
├── package-lock.json   # Node.js 项目依赖锁定文件
├── README.md           # 项目说明文件
├── app/                # 应用程序目录
│   ├── controllers/    # 控制器目录
│   ├── models/         # 模型目录
│   ├── routes/         # 路由目录
│   └── utils/          # 工具类目录
├── bin/                # 可执行文件目录
└── config/             # 配置文件目录
    └── config.json     # 配置文件

• .gitignore: 指定 Git 忽略的文件列表，用于版本控制。
• .editorconfig: 用于配置编辑器的编码、缩进等设置，以提高团队协作效率。
• .env.example: 提供了环境变量设置的示例，用于本地开发环境。
• Dockerfile: 用于构建 Docker 容器的文件。
• docker-compose.yml: 用于定义和运行多容器 Docker 应用程序的配置文件。
• package.json: 包含项目的依赖、脚本和其他元数据。
• package-lock.json: 锁定项目依赖的版本，确保在不同环境中构建一致性。
• README.md: 项目的说明文档，包含项目信息、安装步骤和使用说明。
• app/: 项目的主要应用目录，包含控制器、模型、路由和工具类等。
• config/: 配置文件目录，用于存储项目配置。

2. 项目的启动文件介绍

项目的启动文件为 bin/www，该文件是 Node.js 应用的启动脚本。以下是启动文件的主要内容：

#!/usr/bin/env node

const app = require('../app');
const debug = require('debug')('razorpay-mcp-server:server');
const http = require('http');

const port = normalizePort(process.env.PORT || '3000');
app.set('port', port);

const server = http.createServer(app);

server.listen(port);
server.on('error', onError);
server.on('listening', onListening);

function normalizePort(val) {
  const port = parseInt(val, 10);
  if (isNaN(port)) {
    return val;
  }
  if (port >= 0) {
    return port;
  }
  return false;
}

function onError(error) {
  if (error.syscall !== 'listen') {
    throw error;
  }
  const bind = typeof port === 'string' ? 'Pipe ' + port : 'Port ' + port;
  switch (error.code) {
    case 'EACCES':
      console.error(bind + ' requires elevated privileges');
      process.exit(1);
      break;
    case 'EADDRINUSE':
      console.error(bind + ' is already in use');
      process.exit(1);
      break;
    default:
      throw error;
  }
}

function onListening() {
  const addr = server.address();
  const bind = typeof addr === 'string' ? 'pipe ' + addr : 'port ' + addr.port;
  debug('Listening on ' + bind);
}

启动文件主要做了以下几件事情：

• 导入必要的模块和配置。
• 设置端口号，并创建 HTTP 服务器。
• 监听指定的端口，并在发生错误时给出相应的提示。

3. 项目的配置文件介绍

项目的配置文件为 config/config.json，该文件包含项目运行所需的环境变量和配置信息。以下是配置文件的主要内容：

{
  "port": 3000,
  "database": {
    "host": "localhost",
    "user": "root",
    "password": "",
    "database": "razorpay_mcp_server"
  },
  "razorpay": {
    "key_id": "your_key_id",
    "key_secret": "your_key_secret"
  }
}

配置文件中包含以下配置项：

• port: 项目运行的端口号。
• database: 数据库连接配置，包括数据库主机、用户名、密码和数据库名称。
• razorpay: Razorpay API 配置，包括 API 密钥 ID 和密钥。

在本地开发环境中，可以通过创建一个 .env 文件来覆盖 config.json 中的配置项。例如：

PORT=5000
DB_HOST=localhost
DB_USER=root
DB_PASSWORD=mypassword
DB_DATABASE=razorpay_mcp_server
RAZORPAY_KEY_ID=your_key_id
RAZORPAY_KEY_SECRET=your_key_secret

在 .env 文件中设置的变量将优先于 config.json 中的相应配置项。