@pay2s/mcp 0.4.0

package/README.md

@@ -0,0 +1,76 @@
+# Pay2S MCP
+
+Kết nối Codex, Cursor và ứng dụng hỗ trợ MCP stdio với tài khoản Pay2S. Cần Node.js 22 trở lên trên máy chạy AI và máy chủ Pay2S MCP 0.4 đã đăng ký client `pay2s-cli`.
+
+## Đăng nhập
+
+Sau khi gói được xuất bản lên npm:
+
+```sh
+npx -y @pay2s/mcp login --profile codex
+```
+
+Trình duyệt mở Pay2S. Đăng nhập, chọn quyền và ngân hàng rồi xác nhận. Mỗi ứng dụng dùng một profile riêng: `codex`, `cursor`, `claude`. Tắt phiên AI đang dùng profile trước khi đăng nhập lại profile đó. Tài khoản cần nằm trong danh sách thử nghiệm do Pay2S mở.
+
+## Codex
+
+Trong `~/.codex/config.toml` (Windows: `%USERPROFILE%\.codex\config.toml`), thay riêng mục Pay2S cũ bằng:
+
+```toml
+[mcp_servers.pay2s]
+command = "npx"
+args = ["-y", "@pay2s/mcp", "--profile", "codex"]
+startup_timeout_sec = 180
+tool_timeout_sec = 60
+```
+
+Giữ các cấu hình khác. Bỏ `url`, `scopes` và mục `[mcp_servers.pay2s.oauth]` cũ của cùng kết nối; gói npm tự xử lý đăng nhập. Trên Windows nếu ứng dụng không tìm được npx, dùng đường dẫn đầy đủ đến `npx.cmd` từ `Get-Command npx.cmd`.
+
+Tham khảo cấu hình stdio: https://learn.chatgpt.com/docs/extend/mcp?surface=cli
+
+## Cursor / Claude Desktop
+
+Đăng nhập trước bằng `npx -y @pay2s/mcp login --profile cursor` hoặc `--profile claude`. Thêm vào cấu hình MCP của ứng dụng, giữ các kết nối khác:
+
+```json
+{
+  "mcpServers": {
+    "pay2s": {
+      "command": "npx",
+      "args": ["-y", "@pay2s/mcp", "--profile", "cursor"]
+    }
+  }
+}
+```
+
+Đổi `cursor` thành `claude` khi dùng Claude Desktop. Khởi động lại ứng dụng rồi hỏi trong khung chat: “Kiểm tra tài khoản và quyền kết nối Pay2S của tôi”. Các mẫu này dùng giao thức MCP stdio; cần kiểm tra trên phiên bản ứng dụng thực tế của bạn.
+
+## Chức năng
+
+- Xem ngân hàng, giao dịch, thu chi, đơn và trạng thái thanh toán trong phạm vi được cấp.
+- Tạo link thanh toán khi được cấp quyền riêng.
+- Đề nghị thêm webhook; đề nghị bật/tắt ngân hàng hoặc webhook. AI trả đường dẫn để chủ tài khoản xem và xác nhận trên Pay2S. Gửi đề nghị chưa làm thay đổi trạng thái.
+- `--docs`: chỉ đọc tài liệu công khai, không đăng nhập.
+
+Kết nối cũ cần đăng nhập lại để chọn quyền mới. Ngân hàng đang tắt vẫn xuất hiện để đề nghị bật lại; truy vấn giao dịch vẫn cần ngân hàng hoạt động. Bật webhook không gửi lại giao dịch cũ.
+
+## Phiên đăng nhập
+
+Thông tin phiên được lưu trong thư mục người dùng `~/.pay2s-mcp/<profile>/`, Unix quyền 0700/0600, Windows giới hạn ACL cho người dùng hiện tại và SYSTEM. Không đưa thư mục này vào dự án hoặc gửi cho người khác. Gói không đọc mã nguồn dự án hoặc mật khẩu đăng nhập Pay2S.
+
+```sh
+npx -y @pay2s/mcp logout --profile codex
+```
+
+Lệnh trên xóa phiên tại máy này. Thu hồi kết nối trên https://pay2s.vn/client/ai-connections để chặn quyền truy cập phía máy chủ. Dữ liệu đã gửi đến AI không bị xóa khi thu hồi.
+
+Nếu profile đang được sử dụng, đóng phiên AI đó hoặc chọn profile khác. Sau khi tiến trình bị đóng cưỡng bức, chỉ xóa `process.lock` trong profile khi chắc chắn không còn phiên dùng profile đó. Nếu cổng 14572 bận, hoàn tất lần đăng nhập trước rồi thử lại. Không tự đổi cổng vì callback đã đăng ký cố định.
+
+## Chạy bản đóng gói trước khi xuất bản
+
+```powershell
+npm install -g "C:\laragon\www\FEP2S\artifacts\pay2s-mcp-0.4.0.tgz"
+pay2s-mcp login --profile codex
+```
+
+Cấu hình ứng dụng lúc thử bản này dùng `command = "pay2s-mcp"`, `args = ["--profile", "codex"]`. Không chạy `npx @pay2s/mcp` trước khi package đã xuất bản.

package/bin/pay2s-mcp.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import { openStore } from '../src/store.mjs';
+import { Provider } from '../src/auth.mjs';
+import { proxy } from '../src/proxy.mjs';
+const args = process.argv.slice(2);
+const command = ['login','logout'].includes(args[0]) ? args.shift() : 'serve';
+let profile = 'default', docs = false;
+for (let i=0; i<args.length; i++) {
+  if (args[i] === '--profile') profile = args[++i];
+  else if (args[i] === '--docs') docs = true;
+  else if (['--help','-h'].includes(args[i])) { process.stdout.write('Pay2S MCP\n  npx -y @pay2s/mcp login --profile codex\n  npx -y @pay2s/mcp --profile codex\n  npx -y @pay2s/mcp --docs\n  npx -y @pay2s/mcp logout --profile codex\nNode.js 22+. Each running AI app needs its own profile.\n'); process.exit(0); }
+  else { process.stderr.write('Unknown option. Use --help.\n'); process.exit(1); }
+}
+let store, provider, connection, closing = false;
+async function close() { if (closing) return; closing = true; provider?.close(); await connection?.close().catch(() => {}); await store?.close().catch(() => {}); }
+for (const signal of ['SIGINT','SIGTERM']) process.once(signal, () => { close().finally(() => process.exit(0)); });
+try {
+  if (!docs) {
+    store = await openStore(profile);
+    if (command === 'logout') {
+      await store.save(undefined);
+      process.stderr.write('Local credentials removed. Revoke the connection at https://pay2s.vn/client/ai-connections to end server access.\n');
+    } else {
+      provider = new Provider(store);
+      await provider.login(command === 'login');
+      if (command === 'login') process.stderr.write('Pay2S connected. Start your AI app using the same --profile.\n');
+    }
+  }
+  if (command === 'serve') { connection = await proxy(provider, docs); process.stdin.once('end', () => close()); }
+  else await close();
+} catch (error) {
+  // SDK/HTTP exceptions may contain response bodies; never print them or credentials.
+  const safe = error.message?.startsWith('Profile ') ? error.message : error.code === 'EADDRINUSE' ? 'Port 14572 is busy. Finish the other Pay2S login and retry.' : 'Cannot connect to Pay2S. Check Node 22+, network, deployed MCP 0.4 and account access. Run login with the same --profile again.';
+  process.stderr.write(`${safe}\n`); await close(); process.exitCode = 1;
+}

package/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@pay2s/mcp",
+  "version": "0.4.0",
+  "description": "Connect AI tools to Pay2S through OAuth and MCP",
+  "type": "module",
+  "license": "UNLICENSED",
+  "bin": { "pay2s-mcp": "bin/pay2s-mcp.mjs" },
+  "files": ["bin/", "src/", "README.md"],
+  "engines": { "node": ">=22" },
+  "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org/" },
+  "scripts": { "test": "node --test test/*.test.mjs" },
+  "dependencies": { "@modelcontextprotocol/sdk": "1.31.0" }
+}

package/src/auth.mjs

@@ -0,0 +1,79 @@
+import { createServer } from 'node:http';
+import { randomBytes, timingSafeEqual } from 'node:crypto';
+import { execFile } from 'node:child_process';
+import { auth } from '@modelcontextprotocol/sdk/client/auth.js';
+export const ISSUER = 'https://mcp.pay2s.vn';
+export const RESOURCE = `${ISSUER}/mcp`;
+export const REDIRECT = 'http://127.0.0.1:14572/callback';
+export const SCOPES = 'accounts:read transactions:read payments:read payments:create webhooks:read webhooks:request banks:manage webhooks:manage';
+export async function trustedFetch(input, init = {}) {
+  const url = new URL(typeof input === 'string' || input instanceof URL ? input : input.url);
+  if (url.origin !== ISSUER || url.username || url.password) throw Error('Unexpected Pay2S server');
+  const signal = init.signal ? AbortSignal.any([init.signal, AbortSignal.timeout(45000)]) : AbortSignal.timeout(45000);
+  return fetch(input, { ...init, redirect: 'error', signal });
+}
+export function callbackHandler(state, accept) {
+  let used = false;
+  return (req, res) => {
+    res.setHeader('Cache-Control', 'no-store');
+    res.setHeader('Referrer-Policy', 'no-referrer');
+    res.setHeader('Content-Type', 'text/plain; charset=utf-8');
+    res.setHeader('Content-Security-Policy', "default-src 'none'; frame-ancestors 'none'");
+    const url = new URL(req.url, REDIRECT);
+    const received = url.searchParams.get('state') || '';
+    const valid = Buffer.byteLength(received) === Buffer.byteLength(state) && timingSafeEqual(Buffer.from(received), Buffer.from(state));
+    const duplicate = [...url.searchParams.keys()].some(k => url.searchParams.getAll(k).length !== 1);
+    if (used || req.method !== 'GET' || req.headers.host !== '127.0.0.1:14572' || url.pathname !== '/callback' || duplicate || !valid || url.searchParams.get('iss') !== ISSUER) {
+      res.writeHead(400); res.end('Invalid or expired callback.'); return;
+    }
+    const code = url.searchParams.get('code');
+    if (!code || !/^[a-f0-9]{64}$/.test(code) || url.searchParams.has('error')) {
+      used = true; res.writeHead(400); res.end('Connection was not approved. Return to your terminal.'); accept(null); return;
+    }
+    used = true; res.end('Authorization received. Return to your AI app or terminal to see the connection result.'); accept(code);
+  };
+}
+function openBrowser(url) {
+  // Fixed HTTPS origin and URL serialization; no shell command interpolation.
+  const target = new URL(url);
+  if (target.origin !== ISSUER || target.pathname !== '/oauth/authorize') throw Error('Unexpected authorization URL');
+  const command = process.platform === 'win32' ? 'rundll32.exe' : process.platform === 'darwin' ? 'open' : 'xdg-open';
+  const args = process.platform === 'win32' ? ['url.dll,FileProtocolHandler', target.href] : [target.href];
+  return new Promise(resolve => execFile(command, args, { windowsHide: true }, () => resolve()));
+}
+export class Provider {
+  constructor(store, { fetchFn = trustedFetch, browser = openBrowser } = {}) { this.store = store; this.fetch = fetchFn; this.browser = browser; }
+  get redirectUrl() { return REDIRECT; }
+  get clientMetadata() { return { client_name: 'Pay2S MCP CLI', redirect_uris: [REDIRECT], token_endpoint_auth_method: 'none', grant_types: ['authorization_code','refresh_token'], response_types: ['code'], scope: SCOPES }; }
+  clientInformation() { return { client_id: 'pay2s-cli', issuer: ISSUER }; }
+  tokens() { const t = this.store.read()?.tokens; return t?.issuer === ISSUER ? t : undefined; }
+  async saveTokens(tokens) { await this.store.save({ tokens, expires_at: Date.now() + Math.max(0, Number(tokens.expires_in || 0)) * 1000 }); }
+  async invalidateCredentials(scope) { if (['all','tokens'].includes(scope)) await this.store.save(undefined); if (['all','verifier'].includes(scope)) this.verifier = undefined; }
+  saveCodeVerifier(value) { this.verifier = value; }
+  codeVerifier() { if (!this.verifier) throw Error('Missing code verifier'); return this.verifier; }
+  validateResourceURL(_url, resource) { if (resource !== RESOURCE) throw Error('Unexpected resource'); return Promise.resolve(new URL(RESOURCE)); }
+  state() { this.nonce = randomBytes(32).toString('hex'); return this.nonce; }
+  async redirectToAuthorization(url) {
+    if (!this.interactive) throw Error('Login required. Run npx -y @pay2s/mcp login with the same --profile.');
+    this.callback = new Promise(resolve => { this.receive = resolve; });
+    this.server = createServer(callbackHandler(this.nonce, this.receive));
+    await new Promise((resolve, reject) => { this.server.once('error', reject); this.server.listen(14572, '127.0.0.1', resolve); });
+    this.timer = setTimeout(() => this.receive(null), 180000);
+    process.stderr.write(`Open Pay2S to authorize this connection:\n${url.href}\n`);
+    await this.browser(url);
+  }
+  async login(force = false) {
+    this.interactive = true;
+    try {
+      if (force) await this.invalidateCredentials('tokens');
+      if (!force && this.tokens() && this.store.read().expires_at > Date.now() + 30000) return;
+      const result = await auth(this, { serverUrl: RESOURCE, scope: SCOPES, fetchFn: this.fetch });
+      if (result === 'REDIRECT') {
+        const code = await this.callback;
+        if (!code) throw Error('Login cancelled or timed out');
+        if (await auth(this, { serverUrl: RESOURCE, authorizationCode: code, scope: SCOPES, fetchFn: this.fetch }) !== 'AUTHORIZED') throw Error('Login failed');
+      }
+    } finally { this.interactive = false; this.verifier = undefined; clearTimeout(this.timer); this.server?.close(); this.server?.closeAllConnections(); }
+  }
+  close() { clearTimeout(this.timer); this.receive?.(null); this.server?.close(); this.server?.closeAllConnections(); }
+}

package/src/proxy.mjs

@@ -0,0 +1,22 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ListToolsRequestSchema, CallToolRequestSchema, CallToolResultSchema } from '@modelcontextprotocol/sdk/types.js';
+import { ISSUER, trustedFetch } from './auth.mjs';
+export async function proxy(provider, docs = false) {
+  const transport = new StreamableHTTPClientTransport(new URL(`${ISSUER}/${docs ? 'docs' : 'mcp'}`), { authProvider: provider, fetch: trustedFetch });
+  return connectProxy(transport, new StdioServerTransport());
+}
+export async function connectProxy(transport, localTransport) {
+  const remote = new Client({ name: '@pay2s/mcp', version: '0.4.0' });
+  await remote.connect(transport);
+  const local = new Server({ name: 'pay2s', version: '0.4.0' }, { capabilities: { tools: {} }, instructions: remote.getInstructions() });
+  // Serialize remote calls, including SDK token refresh. Never share a refresh token across processes.
+  let tail = Promise.resolve();
+  const enqueue = fn => { const next = tail.then(fn).catch(() => { throw Error('Pay2S request failed. Check your connection or sign in again.'); }); tail = next.catch(() => {}); return next; };
+  local.setRequestHandler(ListToolsRequestSchema, request => enqueue(() => remote.listTools(request.params)));
+  local.setRequestHandler(CallToolRequestSchema, request => enqueue(() => remote.callTool(request.params, CallToolResultSchema, { timeout: 60000 })));
+  await local.connect(localTransport);
+  return { async close() { await local.close(); await remote.close(); } };
+}

package/src/store.mjs

@@ -0,0 +1,50 @@
+import { mkdir, lstat, chmod, readFile, writeFile, rename, unlink, open } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const exec = promisify(execFile);
+export async function openStore(profile, base = join(homedir(), '.pay2s-mcp')) {
+  if (!/^[a-z0-9_-]{1,32}$/.test(profile)) throw Error('Invalid profile');
+  await mkdir(base, { recursive: true, mode: 0o700 });
+  if (!(await lstat(base)).isDirectory() || (await lstat(base)).isSymbolicLink()) throw Error('Unsafe credential directory');
+  const directory = join(base, profile);
+  await mkdir(directory, { mode: 0o700, recursive: true });
+  const stat = await lstat(directory);
+  if (stat.isSymbolicLink() || !stat.isDirectory()) throw Error('Unsafe profile directory');
+  if (process.platform === 'win32') {
+    const { stdout } = await exec('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', '[System.Security.Principal.WindowsIdentity]::GetCurrent().User.Value'], { windowsHide: true });
+    const sid = stdout.trim();
+    if (!/^S-1-[0-9-]+$/.test(sid)) throw Error('Cannot secure credential directory');
+    // Replace the DACL rather than retaining any pre-existing explicit grants.
+    const script = '$ErrorActionPreference="Stop"; $item=Get-Item -LiteralPath $env:PAY2S_MCP_PROFILE_DIRECTORY; $section=[System.Security.AccessControl.AccessControlSections]::Access; $acl=$item.GetAccessControl($section); $sid=[System.Security.Principal.WindowsIdentity]::GetCurrent().User.Value; $acl.SetSecurityDescriptorSddlForm("D:P(A;OICI;FA;;;$sid)(A;OICI;FA;;;SY)",$section); $item.SetAccessControl($acl)';
+    await exec('powershell.exe', ['-NoProfile','-NonInteractive','-Command',script], { windowsHide: true, env: { ...process.env, PAY2S_MCP_PROFILE_DIRECTORY: directory } });
+  } else {
+    if (stat.uid !== process.getuid()) throw Error('Profile belongs to another user');
+    await chmod(directory, 0o700);
+  }
+  const lockPath = join(directory, 'process.lock');
+  // An exclusive profile prevents simultaneous clients rotating the same refresh token.
+  // A stale lock is not silently removed: this avoids a check/delete race with another client.
+  let lock;
+  try { lock = await open(lockPath, 'wx', 0o600); }
+  catch (e) { if (e.code === 'EEXIST') throw Error(`Profile ${profile} is in use. Use a separate --profile for each AI app. After a crash, remove ${lockPath} only when no client uses it.`); throw e; }
+  await lock.writeFile(String(process.pid));
+  const path = join(directory, 'oauth.json');
+  let saved;
+  try {
+    const s = await lstat(path);
+    if (!s.isFile() || s.isSymbolicLink() || (process.platform !== 'win32' && (s.uid !== process.getuid() || (s.mode & 0o077)))) throw Error('Unsafe credential file permissions');
+    saved = JSON.parse(await readFile(path, 'utf8'));
+  } catch (e) { if (e.code !== 'ENOENT') { await lock.close(); await unlink(lockPath); throw e; } }
+  return {
+    read: () => saved,
+    async save(value) {
+      if (!value) { await unlink(path).catch(e => { if (e.code !== 'ENOENT') throw e; }); saved = undefined; return; }
+      const temp = join(directory, `oauth-${process.pid}.tmp`);
+      await writeFile(temp, JSON.stringify(value), { mode: 0o600, flag: 'wx' });
+      await rename(temp, path); saved = value;
+    },
+    async close() { await lock.close(); await unlink(lockPath); }
+  };
+}