risuaccess-mcp

RisuAI 캐릭터 데이터 접근을 위한 독립형 MCP 서버.

구조

                    ┌─────────────────────────────┐
                    │  risuaccess-mcp             │
                    │  (localhost:3001)           │
                    ├─────────────────────────────┤
                    │  /mcp    - MCP endpoint     │
                    │  /poll   - Plugin polling   │
                    │  /result - Plugin results   │
                    └──────────────┬──────────────┘
                                   │
        ┌──────────────────────────┼──────────────────────────┐
        │                          │                          │
        ▼                          ▼                          ▼
┌──────────────────┐    ┌──────────────────┐    ┌──────────────────┐
│  HTTP Wrapper    │    │  Other MCP       │    │  RisuAI Plugin   │
│  (mcp-config)    │    │  Clients         │    │  (polling)       │
└──────────────────┘    └──────────────────┘    └──────────────────┘

사용법

1. 서버 시작

node C:\Users\damin\risuaccess-mcp\index.js
# 또는 다른 포트로:
node C:\Users\damin\risuaccess-mcp\index.js --port 3002

2. RisuAI 플러그인 설치

risuaccess-plugin.js를 RisuAI 플러그인으로 추가하고 bridge_url을 http://localhost:3001로 설정.

3. mcp-config.json 설정

{
  "risuaccess": {
    "transport": {
      "type": "streamableHttp",
      "url": "http://localhost:3001/mcp"
    }
  }
}

제공 도구 (14개)

| Tool | 설명 | |------|------| | risu-get-character-info | 캐릭터 정보 조회 (이름, 설명, 인사말 등) | | risu-set-character-info | 캐릭터 정보 수정 | | risu-get-character-lorebook | 로어북 항목 조회 | | risu-add-character-lorebook | 로어북 항목 추가 | | risu-set-character-lorebook | 로어북 항목 수정 | | risu-delete-character-lorebook | 로어북 항목 삭제 | | risu-get-chat-history | 채팅 기록 조회 | | risu-get-character-regex-scripts | 정규식 스크립트 조회 | | risu-add-character-regex-scripts | 정규식 스크립트 추가 | | risu-set-character-regex-scripts | 정규식 스크립트 수정 | | risu-delete-character-regex-scripts | 정규식 스크립트 삭제 | | risu-get-character-additional-assets | 추가 에셋 조회 | | risu-delete-character-additional-assets | 추가 에셋 삭제 | | risu-list-characters | 캐릭터 목록 (현재 캐릭터만) |

엔드포인트

• GET / - 서버 상태
• GET /health - 헬스체크
• POST /mcp - MCP JSON-RPC 엔드포인트
• POST /poll - 플러그인 폴링
• POST /result - 플러그인 결과 반환