@basicbit/vrchat-mcp 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +5 -0
- package/README.md +1 -1
- package/dist/package.json +4 -2
- package/package.json +4 -2
- package/server.json +220 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,10 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.1.1 - 2026-05-16
|
|
4
|
+
|
|
5
|
+
- Add MCP Registry metadata and npm ownership marker for registry publication.
|
|
6
|
+
- Move the documented and CI runtime baseline to Node.js 24.15.0, the current LTS baseline used for release validation.
|
|
7
|
+
|
|
3
8
|
## 0.1.0 - 2026-05-15
|
|
4
9
|
|
|
5
10
|
Initial public release.
|
package/README.md
CHANGED
|
@@ -37,7 +37,7 @@ This project is unofficial and is not affiliated with VRChat Inc.
|
|
|
37
37
|
|
|
38
38
|
Requirements:
|
|
39
39
|
|
|
40
|
-
- Node.js
|
|
40
|
+
- Node.js 24.15.0 or newer. This is the current LTS baseline used for CI and release validation.
|
|
41
41
|
- An MCP client such as Claude Desktop, OpenCode, or another MCP-compatible host.
|
|
42
42
|
|
|
43
43
|
Run from npm:
|
package/dist/package.json
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@basicbit/vrchat-mcp",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"mcpName": "io.github.basic-bit/vrchat-mcp",
|
|
4
5
|
"description": "MCP server for VRChat friends, worlds, groups, events, notifications, and VRCX history.",
|
|
5
6
|
"type": "module",
|
|
6
7
|
"main": "dist/src/index.js",
|
|
@@ -22,6 +23,7 @@
|
|
|
22
23
|
"docs/vrcx.md",
|
|
23
24
|
"README.md",
|
|
24
25
|
"CHANGELOG.md",
|
|
26
|
+
"server.json",
|
|
25
27
|
"LICENSE"
|
|
26
28
|
],
|
|
27
29
|
"scripts": {
|
|
@@ -55,7 +57,7 @@
|
|
|
55
57
|
"metrics": "npm run metrics:scc && npm run metrics:lizard"
|
|
56
58
|
},
|
|
57
59
|
"engines": {
|
|
58
|
-
"node": ">=
|
|
60
|
+
"node": ">=24.15.0"
|
|
59
61
|
},
|
|
60
62
|
"keywords": [
|
|
61
63
|
"vrchat",
|
package/package.json
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@basicbit/vrchat-mcp",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"mcpName": "io.github.basic-bit/vrchat-mcp",
|
|
4
5
|
"description": "MCP server for VRChat friends, worlds, groups, events, notifications, and VRCX history.",
|
|
5
6
|
"type": "module",
|
|
6
7
|
"main": "dist/src/index.js",
|
|
@@ -22,6 +23,7 @@
|
|
|
22
23
|
"docs/vrcx.md",
|
|
23
24
|
"README.md",
|
|
24
25
|
"CHANGELOG.md",
|
|
26
|
+
"server.json",
|
|
25
27
|
"LICENSE"
|
|
26
28
|
],
|
|
27
29
|
"scripts": {
|
|
@@ -55,7 +57,7 @@
|
|
|
55
57
|
"metrics": "npm run metrics:scc && npm run metrics:lizard"
|
|
56
58
|
},
|
|
57
59
|
"engines": {
|
|
58
|
-
"node": ">=
|
|
60
|
+
"node": ">=24.15.0"
|
|
59
61
|
},
|
|
60
62
|
"keywords": [
|
|
61
63
|
"vrchat",
|
package/server.json
ADDED
|
@@ -0,0 +1,220 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
|
|
3
|
+
"name": "io.github.basic-bit/vrchat-mcp",
|
|
4
|
+
"title": "VRChat MCP",
|
|
5
|
+
"description": "MCP server for VRChat friends, worlds, groups, events, notifications, and VRCX history.",
|
|
6
|
+
"repository": {
|
|
7
|
+
"url": "https://github.com/BASIC-BIT/vrchat-mcp",
|
|
8
|
+
"source": "github",
|
|
9
|
+
"id": "1122295987"
|
|
10
|
+
},
|
|
11
|
+
"version": "0.1.1",
|
|
12
|
+
"packages": [
|
|
13
|
+
{
|
|
14
|
+
"registryType": "npm",
|
|
15
|
+
"identifier": "@basicbit/vrchat-mcp",
|
|
16
|
+
"version": "0.1.1",
|
|
17
|
+
"transport": {
|
|
18
|
+
"type": "stdio"
|
|
19
|
+
},
|
|
20
|
+
"environmentVariables": [
|
|
21
|
+
{
|
|
22
|
+
"name": "VRCHAT_MCP_CONFIG_FILE",
|
|
23
|
+
"description": "Path to a JSON config file for settings not supplied through environment variables.",
|
|
24
|
+
"format": "filepath",
|
|
25
|
+
"isRequired": false,
|
|
26
|
+
"isSecret": false
|
|
27
|
+
},
|
|
28
|
+
{
|
|
29
|
+
"name": "VRCHAT_MCP_API_BASE",
|
|
30
|
+
"description": "VRChat API base URL override.",
|
|
31
|
+
"format": "string",
|
|
32
|
+
"isRequired": false,
|
|
33
|
+
"isSecret": false
|
|
34
|
+
},
|
|
35
|
+
{
|
|
36
|
+
"name": "VRCHAT_MCP_USER_AGENT",
|
|
37
|
+
"description": "Descriptive User-Agent for VRChat API requests.",
|
|
38
|
+
"format": "string",
|
|
39
|
+
"isRequired": false,
|
|
40
|
+
"isSecret": false
|
|
41
|
+
},
|
|
42
|
+
{
|
|
43
|
+
"name": "VRCHAT_MCP_SPEC_URL",
|
|
44
|
+
"description": "OpenAPI spec URL or file path override.",
|
|
45
|
+
"format": "string",
|
|
46
|
+
"isRequired": false,
|
|
47
|
+
"isSecret": false
|
|
48
|
+
},
|
|
49
|
+
{
|
|
50
|
+
"name": "VRCHAT_MCP_LOG_LEVEL",
|
|
51
|
+
"description": "Log level for stderr diagnostics.",
|
|
52
|
+
"format": "string",
|
|
53
|
+
"choices": ["debug", "info", "warn", "error"],
|
|
54
|
+
"default": "info",
|
|
55
|
+
"isRequired": false,
|
|
56
|
+
"isSecret": false
|
|
57
|
+
},
|
|
58
|
+
{
|
|
59
|
+
"name": "VRCHAT_MCP_COOKIE_STORE",
|
|
60
|
+
"description": "Cookie storage backend for VRChat authentication.",
|
|
61
|
+
"format": "string",
|
|
62
|
+
"choices": ["memory", "file", "keychain"],
|
|
63
|
+
"default": "memory",
|
|
64
|
+
"isRequired": false,
|
|
65
|
+
"isSecret": false
|
|
66
|
+
},
|
|
67
|
+
{
|
|
68
|
+
"name": "VRCHAT_MCP_COOKIE_FILE",
|
|
69
|
+
"description": "Cookie file path used when VRCHAT_MCP_COOKIE_STORE is file.",
|
|
70
|
+
"format": "filepath",
|
|
71
|
+
"isRequired": false,
|
|
72
|
+
"isSecret": false
|
|
73
|
+
},
|
|
74
|
+
{
|
|
75
|
+
"name": "VRCHAT_MCP_ALLOW_WRITES",
|
|
76
|
+
"description": "Enable non-GET VRChat API write operations.",
|
|
77
|
+
"format": "boolean",
|
|
78
|
+
"default": "false",
|
|
79
|
+
"isRequired": false,
|
|
80
|
+
"isSecret": false
|
|
81
|
+
},
|
|
82
|
+
{
|
|
83
|
+
"name": "VRCHAT_MCP_GROUP_ALLOWLIST",
|
|
84
|
+
"description": "Comma-separated group IDs permitted for group write actions.",
|
|
85
|
+
"format": "string",
|
|
86
|
+
"isRequired": false,
|
|
87
|
+
"isSecret": false
|
|
88
|
+
},
|
|
89
|
+
{
|
|
90
|
+
"name": "VRCHAT_MCP_CACHE_ENABLED",
|
|
91
|
+
"description": "Enable in-memory caching for high-volume reads.",
|
|
92
|
+
"format": "boolean",
|
|
93
|
+
"default": "true",
|
|
94
|
+
"isRequired": false,
|
|
95
|
+
"isSecret": false
|
|
96
|
+
},
|
|
97
|
+
{
|
|
98
|
+
"name": "VRCHAT_MCP_CACHE_TTL_FRIENDS",
|
|
99
|
+
"description": "Fresh cache TTL in seconds for friends data.",
|
|
100
|
+
"format": "number",
|
|
101
|
+
"default": "120",
|
|
102
|
+
"isRequired": false,
|
|
103
|
+
"isSecret": false
|
|
104
|
+
},
|
|
105
|
+
{
|
|
106
|
+
"name": "VRCHAT_MCP_CACHE_STALE_TTL_FRIENDS",
|
|
107
|
+
"description": "Stale cache TTL in seconds for friends data.",
|
|
108
|
+
"format": "number",
|
|
109
|
+
"default": "600",
|
|
110
|
+
"isRequired": false,
|
|
111
|
+
"isSecret": false
|
|
112
|
+
},
|
|
113
|
+
{
|
|
114
|
+
"name": "VRCHAT_MCP_CACHE_TTL_USER_GROUPS",
|
|
115
|
+
"description": "Fresh cache TTL in seconds for user group data.",
|
|
116
|
+
"format": "number",
|
|
117
|
+
"default": "300",
|
|
118
|
+
"isRequired": false,
|
|
119
|
+
"isSecret": false
|
|
120
|
+
},
|
|
121
|
+
{
|
|
122
|
+
"name": "VRCHAT_MCP_CACHE_STALE_TTL_USER_GROUPS",
|
|
123
|
+
"description": "Stale cache TTL in seconds for user group data.",
|
|
124
|
+
"format": "number",
|
|
125
|
+
"default": "1800",
|
|
126
|
+
"isRequired": false,
|
|
127
|
+
"isSecret": false
|
|
128
|
+
},
|
|
129
|
+
{
|
|
130
|
+
"name": "VRCHAT_MCP_CACHE_TTL_GROUPS",
|
|
131
|
+
"description": "Fresh cache TTL in seconds for group data.",
|
|
132
|
+
"format": "number",
|
|
133
|
+
"default": "300",
|
|
134
|
+
"isRequired": false,
|
|
135
|
+
"isSecret": false
|
|
136
|
+
},
|
|
137
|
+
{
|
|
138
|
+
"name": "VRCHAT_MCP_CACHE_STALE_TTL_GROUPS",
|
|
139
|
+
"description": "Stale cache TTL in seconds for group data.",
|
|
140
|
+
"format": "number",
|
|
141
|
+
"default": "1800",
|
|
142
|
+
"isRequired": false,
|
|
143
|
+
"isSecret": false
|
|
144
|
+
},
|
|
145
|
+
{
|
|
146
|
+
"name": "VRCHAT_MCP_CACHE_TTL_NOTIFICATIONS",
|
|
147
|
+
"description": "Fresh cache TTL in seconds for notification data.",
|
|
148
|
+
"format": "number",
|
|
149
|
+
"default": "30",
|
|
150
|
+
"isRequired": false,
|
|
151
|
+
"isSecret": false
|
|
152
|
+
},
|
|
153
|
+
{
|
|
154
|
+
"name": "VRCHAT_MCP_CACHE_STALE_TTL_NOTIFICATIONS",
|
|
155
|
+
"description": "Stale cache TTL in seconds for notification data.",
|
|
156
|
+
"format": "number",
|
|
157
|
+
"default": "300",
|
|
158
|
+
"isRequired": false,
|
|
159
|
+
"isSecret": false
|
|
160
|
+
},
|
|
161
|
+
{
|
|
162
|
+
"name": "VRCHAT_MCP_PIPELINE_ENABLED",
|
|
163
|
+
"description": "Enable the VRChat realtime pipeline websocket after login.",
|
|
164
|
+
"format": "boolean",
|
|
165
|
+
"default": "true",
|
|
166
|
+
"isRequired": false,
|
|
167
|
+
"isSecret": false
|
|
168
|
+
},
|
|
169
|
+
{
|
|
170
|
+
"name": "VRCHAT_MCP_PIPELINE_URL",
|
|
171
|
+
"description": "VRChat realtime pipeline websocket URL override.",
|
|
172
|
+
"format": "string",
|
|
173
|
+
"isRequired": false,
|
|
174
|
+
"isSecret": false
|
|
175
|
+
},
|
|
176
|
+
{
|
|
177
|
+
"name": "VRCHAT_MCP_PIPELINE_RECONNECT_MS",
|
|
178
|
+
"description": "Realtime pipeline reconnect delay in milliseconds.",
|
|
179
|
+
"format": "number",
|
|
180
|
+
"default": "5000",
|
|
181
|
+
"isRequired": false,
|
|
182
|
+
"isSecret": false
|
|
183
|
+
},
|
|
184
|
+
{
|
|
185
|
+
"name": "VRCHAT_MCP_PIPELINE_CHANGE_BUFFER",
|
|
186
|
+
"description": "Maximum in-memory friend change events retained.",
|
|
187
|
+
"format": "number",
|
|
188
|
+
"default": "200",
|
|
189
|
+
"isRequired": false,
|
|
190
|
+
"isSecret": false
|
|
191
|
+
},
|
|
192
|
+
{
|
|
193
|
+
"name": "VRCHAT_MCP_ENABLE_RAW_CALL",
|
|
194
|
+
"description": "Enable the low-level raw VRChat API call tool.",
|
|
195
|
+
"format": "boolean",
|
|
196
|
+
"default": "false",
|
|
197
|
+
"isRequired": false,
|
|
198
|
+
"isSecret": false
|
|
199
|
+
},
|
|
200
|
+
{
|
|
201
|
+
"name": "VRCHAT_MCP_DISABLE_GENERATED_READ_TOOLS",
|
|
202
|
+
"description": "Disable generated read tools from the VRChat OpenAPI spec.",
|
|
203
|
+
"format": "boolean",
|
|
204
|
+
"default": "false",
|
|
205
|
+
"isRequired": false,
|
|
206
|
+
"isSecret": false
|
|
207
|
+
},
|
|
208
|
+
{
|
|
209
|
+
"name": "VRCHAT_MCP_DISABLE_GENERATED_WRITE_TOOLS",
|
|
210
|
+
"description": "Disable generated write tools from the VRChat OpenAPI spec.",
|
|
211
|
+
"format": "boolean",
|
|
212
|
+
"default": "false",
|
|
213
|
+
"isRequired": false,
|
|
214
|
+
"isSecret": false
|
|
215
|
+
}
|
|
216
|
+
]
|
|
217
|
+
}
|
|
218
|
+
],
|
|
219
|
+
"websiteUrl": "https://github.com/BASIC-BIT/vrchat-mcp#readme"
|
|
220
|
+
}
|