{"_id":"@beosin/kyt-mcp-server","_rev":"2-f1ee9e6ae9e22268bee3ff9c9100772f","name":"@beosin/kyt-mcp-server","dist-tags":{"latest":"1.0.5"},"versions":{"1.0.4":{"name":"@beosin/kyt-mcp-server","version":"1.0.4","keywords":["mcp","mcp-server","kyt","beosin","blockchain","risk-assessment","cryptocurrency"],"author":{"name":"starstar214"},"license":"MIT","_id":"@beosin/kyt-mcp-server@1.0.4","maintainers":[{"name":"beosinmcp","email":"support@beosin.com"}],"homepage":"https://github.com/starstar214/kyt-mcp-server#readme","bugs":{"url":"https://github.com/starstar214/kyt-mcp-server/issues"},"bin":{"kyt-mcp-server":"bin/kyt-mcp-server.js"},"dist":{"shasum":"001e44f99067939c0544af7fa9c834b3ae1db7cb","tarball":"https://registry.npmjs.org/@beosin/kyt-mcp-server/-/kyt-mcp-server-1.0.4.tgz","fileCount":18,"integrity":"sha512-lI2uPILjaLf7kb4FO+4vat3F3aiLDTnjtiQlTamLyKl6x0a60pfDR8RGm1sr7ynfPNt8qoWoceTR6NEemCFxew==","signatures":[{"sig":"MEUCIQDfneyEg1gLsHAb59fg3834wE0EVVlE7N/Baz+P5OatuQIgSwVcHruqD4AtwplsOk6pUJ25rqDfO9+8VBIOg7U0FXk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":108690},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"bba168f4a363f8d026fd5d27db0d03c4cc723aec","scripts":{"dev":"npx tsc && node dist/index.js","build":"npx tsc","start":"node dist/index.js","prepublishOnly":"npm install && npm run build"},"_npmUser":{"name":"beosinmcp","email":"support@beosin.com"},"repository":{"url":"git+https://github.com/starstar214/kyt-mcp-server.git","type":"git"},"_npmVersion":"11.11.0","description":"MCP Server for Beosin KYT API - Blockchain risk assessment","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^3.22.4","xlsx":"^0.18.5","axios":"^1.6.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.2","@types/node":"^20.10.0"},"_npmOperationalInternal":{"tmp":"tmp/kyt-mcp-server_1.0.4_1775724631480_0.3130225912784508","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@beosin/kyt-mcp-server","version":"1.0.5","description":"MCP Server for Beosin KYT API - Blockchain risk assessment","main":"dist/index.js","type":"module","bin":{"kyt-mcp-server":"bin/kyt-mcp-server.js"},"scripts":{"build":"npx tsc","start":"node dist/index.js","dev":"npx tsc && node dist/index.js","prepublishOnly":"npm install && npm run build"},"keywords":["mcp","mcp-server","kyt","beosin","blockchain","risk-assessment","cryptocurrency"],"author":{"name":"beosin"},"license":"MIT","engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","axios":"^1.6.0","xlsx":"^0.18.5","zod":"^3.22.4"},"devDependencies":{"@types/node":"^20.10.0","typescript":"^5.3.2"},"gitHead":"bba168f4a363f8d026fd5d27db0d03c4cc723aec","types":"./dist/index.d.ts","_id":"@beosin/kyt-mcp-server@1.0.5","_nodeVersion":"24.14.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-HtHdYxmzJdPaFRR8vyKVa5PgjUhQr2WSNgwPJo/t3lPhZaQMk6Bq0KMSGhw2JFhOMibCpSgm6trUGNA8Vx0iGQ==","shasum":"4b9cbf7b48b9684e40edfe808f9d354a74eb1b25","tarball":"https://registry.npmjs.org/@beosin/kyt-mcp-server/-/kyt-mcp-server-1.0.5.tgz","fileCount":18,"unpackedSize":108652,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBsgTIZgW7w+po6KHWbH5W1/UPCA8iwEG7t1YMsR3AEzAiAS+Aa9+ou7rJ01JoZbk1dxzWgd8lu2aqTckXHrrfN00A=="}]},"_npmUser":{"name":"beosinmcp","email":"support@beosin.com"},"directories":{},"maintainers":[{"name":"beosinmcp","email":"support@beosin.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/kyt-mcp-server_1.0.5_1775736164514_0.46097438325928297"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-09T08:50:31.401Z","modified":"2026-04-09T12:02:45.133Z","1.0.4":"2026-04-09T08:50:31.610Z","1.0.5":"2026-04-09T12:02:44.712Z"},"author":{"name":"beosin"},"license":"MIT","keywords":["mcp","mcp-server","kyt","beosin","blockchain","risk-assessment","cryptocurrency"],"description":"MCP Server for Beosin KYT API - Blockchain risk assessment","maintainers":[{"name":"beosinmcp","email":"support@beosin.com"}],"readme":"# KYT MCP Server\n\nMCP (Model Context Protocol) Server for Beosin KYT API - 区块链风险评估服务\n\n## 功能概述\n\n本 MCP Server 封装了 Beosin KYT 的3个API接口，为大模型提供区块链地址和交易风险评估能力：\n\n| 工具名称 | 功能 | 场景 |\n|---------|------|------|\n| `get_address_risk` | 地址风险评估 | 评估钱包地址风险等级 |\n| `get_deposit_transaction_risk` | 存款交易风险评估 | 评估资金来源风险 |\n| `get_withdraw_transaction_risk` | 提款交易风险评估 | 评估资金去向风险 |\n\n## 安装\n\n### 1. 安装依赖\n\n```bash\nnpm install\n```\n\n### 2. 编译 TypeScript\n\n```bash\nnpm run build\n```\n\n### 3. 配置环境变量\n\n设置以下环境变量：\n\n```bash\nexport KYT_APP_ID=\"your_app_id\"\nexport KYT_APP_SECRET=\"your_app_secret\"\nexport KYT_BASE_URL=\"https://api.beosin.com\"  # 可选，默认值\nexport KYT_TIMEOUT=\"30000\"  # 可选，默认30000ms\n```\n\n或在 Windows (PowerShell)：\n\n```powershell\n$env:KYT_APP_ID=\"your_app_id\"\n$env:KYT_APP_SECRET=\"your_app_secret\"\n```\n\n## 使用\n\n### 启动服务器\n\n```bash\nnpm start\n# 或\nnode dist/index.js\n```\n\n服务器通过 stdio 与大模型通信。\n\n## 配置到大模型\n\n### Cursor\n\n1. 打开 Cursor 设置 (Cmd/Ctrl + ,)\n2. 进入 **MCP** 页面\n3. 点击 **Add new MCP Server**\n4. 填写配置：\n\n```json\n{\n  \"name\": \"kyt-risk-assessment\",\n  \"command\": \"node\",\n  \"args\": [\"/path/to/kyt-mcp-server/dist/index.js\"],\n  \"env\": {\n    \"KYT_APP_ID\": \"your_app_id\",\n    \"KYT_APP_SECRET\": \"your_app_secret\"\n  }\n}\n```\n\n### Claude Desktop\n\n编辑 `claude_desktop_config.json`：\n\n```json\n{\n  \"mcpServers\": {\n    \"kyt\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/kyt-mcp-server/dist/index.js\"],\n      \"env\": {\n        \"KYT_APP_ID\": \"your_app_id\",\n        \"KYT_APP_SECRET\": \"your_app_secret\"\n      }\n    }\n  }\n}\n```\n\n配置文件位置：\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n### 其他支持 MCP 的大模型\n\n参考您使用的大模型的 MCP 配置文档，配置方式类似。\n\n## API 工具详情\n\n### get_address_risk\n\n评估区块链地址的风险等级。\n\n**参数：**\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| chainId | string | 是 | 链ID (1=Ethereum, 137=Polygon, 43114=Avalanche) |\n| address | string | 是 | 地址哈希 |\n| token | string | 否 | 代币地址 (非原生代币时必填) |\n\n**返回：**\n- `score`: 总风险评分\n- `riskLevel`: 风险等级 (Severe/High/Medium/Low)\n- `incomingScore`: 入金风险评分\n- `outgoingScore`: 出金风险评分\n- `incomingDetail`/`outgoingDetail`: 详细风险因素\n\n### get_deposit_transaction_risk\n\n评估存款/入金交易风险。\n\n**参数：**\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| chainId | string | 是 | 链ID |\n| hash | string | 是 | 交易哈希 |\n| token | string | 否 | 代币地址或名称 |\n\n**返回：**\n- `score`: 风险评分\n- `riskLevel`: 风险等级\n- `risks[]`: 风险详情列表\n\n### get_withdraw_transaction_risk\n\n评估提款/出金交易风险。\n\n**参数：**\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| chainId | string | 是 | 链ID |\n| hash | string | 是 | 交易哈希 |\n| token | string | 否 | 代币地址或名称 |\n\n**返回：**\n- `score`: 风险评分\n- `riskLevel`: 风险等级\n- `risks[]`: 风险详情列表\n\n## 示例对话\n\n```\n用户: 评估这个地址的风险等级: 0xc0e80a623c9593b3c3911682d2084c4e93bea4a7，链是以太坊\n\n大模型调用: get_address_risk({ chainId: \"1\", address: \"0xc0e80a623c9593b3c3911682d2084c4e93bea4a7\" })\n\n返回: {\n  \"code\": 200,\n  \"data\": {\n    \"score\": 90,\n    \"riskLevel\": \"Low\",\n    ...\n  }\n}\n```\n\n## 错误处理\n\n| 错误码 | 说明 |\n|-------|------|\n| 40001 | 参数错误 |\n| 40021 | 不支持的平台 |\n| 40023 | 交易哈希错误 |\n| 41023 | 交易哈希不存在 |\n| 41024 | 不支持非ERC-20交易评估 |\n| 41035 | 代币不在代币篮子中 |\n| 41038 | 任务正在执行中，稍后重试 |\n\n## 开发\n\n```bash\n# 开发模式 (自动编译并运行)\nnpm run dev\n\n# 类型检查\nnpx tsc --noEmit\n```\n","readmeFilename":"README.md"}