mcp-ramp-server 1.0.0

package/README.md

@@ -0,0 +1,103 @@
+# @nexus-ai/mcp-ramp
+
+Cross-Ramp SDK MCP Server - 게임자산 블록체인 토큰 변환 API 문서 검색
+
+## 설치
+
+```bash
+npm install -g @nexus-ai/mcp-ramp
+```
+
+## Cursor IDE 설정
+
+`~/.cursor/mcp.json` 파일에 추가:
+
+```json
+{
+  "mcpServers": {
+    "ramp": {
+      "command": "npx",
+      "args": ["-y", "@nexus-ai/mcp-ramp"]
+    }
+  }
+}
+```
+
+또는 글로벌 설치 후:
+
+```json
+{
+  "mcpServers": {
+    "ramp": {
+      "command": "mcp-ramp"
+    }
+  }
+}
+```
+
+## Claude Desktop 설정
+
+`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) 또는
+`%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "ramp": {
+      "command": "npx",
+      "args": ["-y", "@nexus-ai/mcp-ramp"]
+    }
+  }
+}
+```
+
+## 사용 가능한 도구
+
+### Search_Ramp_Docs
+
+Cross-Ramp SDK 문서 검색 도구.
+
+**사용 예시:**
+
+| 쿼리 | 설명 |
+|------|------|
+| `search Unity WebView` | Unity WebView 관련 코드 검색 |
+| `guide web setup` | Web 플랫폼 초기 설정 가이드 |
+| `guide unity auth` | Unity 인증 토큰 가이드 |
+| `debug cors web` | CORS 에러 디버깅 |
+| `concept mint` | Mint 개념 설명 |
+| `concept burn` | Burn 개념 설명 |
+| `quickstart unity typescript` | Unity TypeScript Quick Start |
+| `sample typescript auth` | TypeScript 인증 샘플 코드 |
+| `apiref webhook` | Webhook API 스펙 |
+| `console-search token` | Console API에서 토큰 관련 검색 |
+
+## 핵심 개념
+
+| 개념 | 설명 |
+|------|------|
+| **Mint** | 게임자산 → 블록체인 토큰 변환 |
+| **Burn** | 블록체인 토큰 → 게임자산 변환 |
+| **Catalog** | Cross-Ramp 교환 UI |
+
+## 지원 플랫폼
+
+- **Web**: Next.js, React
+- **Unity**: Unity WebView
+- **Backend**: Go, C#, Node.js
+
+## 환경 URL
+
+| 환경 | URL | Network |
+|------|-----|---------|
+| 테스트 | stg-ramp.crosstoken.io | testnet |
+| 운영 | ramp.crosstoken.io | mainnet |
+
+## 참고 자료
+
+- [cross-ramp-demos](https://github.com/to-nexus/cross-ramp-demos) - Web/Unity 데모
+- [cross-ramp-integration-sample](https://github.com/to-nexus/cross-ramp-integration-sample) - Backend 샘플
+
+## 라이선스
+
+MIT

package/bin/ramp-mcp.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+
+const SSE_ENDPOINT = 'https://tonexus.app.n8n.cloud/mcp/ramp/sse';
+
+// supergateway를 사용하여 SSE → stdio 변환
+const child = spawn('npx', ['-y', 'supergateway', '--sse', SSE_ENDPOINT], {
+  stdio: 'inherit',
+  shell: process.platform === 'win32'
+});
+
+child.on('error', (err) => {
+  console.error('[ramp-mcp] Failed to start MCP server:', err.message);
+  console.error('[ramp-mcp] Make sure you have Node.js 18+ and npx available.');
+  process.exit(1);
+});
+
+child.on('close', (code) => {
+  process.exit(code || 0);
+});
+
+// Handle termination signals
+process.on('SIGINT', () => {
+  child.kill('SIGINT');
+});
+
+process.on('SIGTERM', () => {
+  child.kill('SIGTERM');
+});

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "mcp-ramp-server",
+  "version": "1.0.0",
+  "description": "Cross-Ramp SDK MCP Server - Mint/Burn 게임자산 블록체인 토큰 변환 API 문서 검색",
+  "author": "Nexus AI",
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "cross-ramp",
+    "blockchain",
+    "gaming",
+    "nft",
+    "mint",
+    "burn",
+    "nexus-ai"
+  ],
+  "bin": {
+    "mcp-ramp": "./bin/ramp-mcp.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nexus-ai/mcp-ramp"
+  },
+  "homepage": "https://github.com/nexus-ai/mcp-ramp#readme",
+  "bugs": {
+    "url": "https://github.com/nexus-ai/mcp-ramp/issues"
+  }
+}