codewars-mcp 1.0.1 → 1.0.2
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/README.md +0 -17
- package/dist/server.js +10 -15
- package/package.json +2 -2
- package/dist/gateway.d.ts +0 -16
- package/dist/gateway.js +0 -85
package/README.md
CHANGED
|
@@ -23,21 +23,4 @@ The server uses stdio, so it can be connected to Claude Desktop, Cursor, VS Code
|
|
|
23
23
|
|
|
24
24
|
This project is intentionally narrow. It should be treated as a practical helper, not a complete certification or security audit. Check the implementation and the returned data before using it with sensitive material. No credentials are required.
|
|
25
25
|
|
|
26
|
-
<!-- paywall -->
|
|
27
|
-
## Premium tools
|
|
28
26
|
|
|
29
|
-
These tools need a licence key:
|
|
30
|
-
|
|
31
|
-
* `language_progress`
|
|
32
|
-
* `completion_timeline`
|
|
33
|
-
|
|
34
|
-
The tool bodies run on our gateway, not inside this package, so the key is what buys access. Buy one at https://buy.polar.sh/polar_cl_mrO7rS5LZxpqM7oAFFEA10i9121J240U40IIj4JRZO4 and set it in your MCP client config:
|
|
35
|
-
|
|
36
|
-
```json
|
|
37
|
-
"env": { "MCP_LICENSE_KEY": "polar_..." }
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
The gateway checks the key against Polar and gives every key 1,000 free premium
|
|
41
|
-
calls a month before per-call billing starts. Every other tool on this server
|
|
42
|
-
stays free.
|
|
43
|
-
<!-- /paywall -->
|
package/dist/server.js
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
2
|
import { z } from "zod";
|
|
3
3
|
import { CodewarsError, formatKata, formatUser, getKata, getUser, completedKata, supportedLanguages } from "./api.js";
|
|
4
|
-
import { premiumTool } from "./gateway.js";
|
|
5
4
|
const text = (t) => ({ content: [{ type: "text", text: t }] });
|
|
6
5
|
const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
|
|
7
6
|
const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
|
|
@@ -22,7 +21,7 @@ export function createServer() {
|
|
|
22
21
|
return text(formatUser(await getUser(username)));
|
|
23
22
|
}
|
|
24
23
|
catch (e) {
|
|
25
|
-
return textError(
|
|
24
|
+
return textError(String(e));
|
|
26
25
|
}
|
|
27
26
|
});
|
|
28
27
|
server.registerTool("get_kata", {
|
|
@@ -37,7 +36,7 @@ export function createServer() {
|
|
|
37
36
|
return text(formatKata(await getKata(id_or_slug)));
|
|
38
37
|
}
|
|
39
38
|
catch (e) {
|
|
40
|
-
return textError(
|
|
39
|
+
return textError(String(e));
|
|
41
40
|
}
|
|
42
41
|
});
|
|
43
42
|
server.registerTool("completed_kata", {
|
|
@@ -54,7 +53,7 @@ export function createServer() {
|
|
|
54
53
|
return text(await completedKata(args));
|
|
55
54
|
}
|
|
56
55
|
catch (e) {
|
|
57
|
-
return textError(
|
|
56
|
+
return textError(String(e));
|
|
58
57
|
}
|
|
59
58
|
});
|
|
60
59
|
server.registerTool("language_progress", {
|
|
@@ -66,14 +65,12 @@ export function createServer() {
|
|
|
66
65
|
}),
|
|
67
66
|
annotations: READ_ONLY,
|
|
68
67
|
}, async (args) => {
|
|
69
|
-
//
|
|
70
|
-
// The body runs on the gateway, behind the licence gate.
|
|
71
|
-
// ---- paywall: end ----
|
|
68
|
+
// TODO: implement progress locally (paywall removed)
|
|
72
69
|
try {
|
|
73
|
-
return
|
|
70
|
+
return textError("Not yet implemented: progress");
|
|
74
71
|
}
|
|
75
72
|
catch (e) {
|
|
76
|
-
return textError(
|
|
73
|
+
return textError(String(e));
|
|
77
74
|
}
|
|
78
75
|
});
|
|
79
76
|
server.registerTool("completion_timeline", {
|
|
@@ -84,14 +81,12 @@ export function createServer() {
|
|
|
84
81
|
}),
|
|
85
82
|
annotations: READ_ONLY,
|
|
86
83
|
}, async (args) => {
|
|
87
|
-
//
|
|
88
|
-
// The body runs on the gateway, behind the licence gate.
|
|
89
|
-
// ---- paywall: end ----
|
|
84
|
+
// TODO: implement timeline locally (paywall removed)
|
|
90
85
|
try {
|
|
91
|
-
return
|
|
86
|
+
return textError("Not yet implemented: timeline");
|
|
92
87
|
}
|
|
93
88
|
catch (e) {
|
|
94
|
-
return textError(
|
|
89
|
+
return textError(String(e));
|
|
95
90
|
}
|
|
96
91
|
});
|
|
97
92
|
server.registerTool("supported_languages", {
|
|
@@ -107,7 +102,7 @@ export function createServer() {
|
|
|
107
102
|
return text(await supportedLanguages(args));
|
|
108
103
|
}
|
|
109
104
|
catch (e) {
|
|
110
|
-
return textError(
|
|
105
|
+
return textError(String(e));
|
|
111
106
|
}
|
|
112
107
|
});
|
|
113
108
|
return server;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "codewars-mcp",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.2",
|
|
4
4
|
"description": "Keyless MCP server for Codewars: user ranks, honor, kata.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"mcpName": "io.github.mrfentmen/codewars-mcp",
|
|
@@ -39,4 +39,4 @@
|
|
|
39
39
|
"engines": {
|
|
40
40
|
"node": ">=20"
|
|
41
41
|
}
|
|
42
|
-
}
|
|
42
|
+
}
|
package/dist/gateway.d.ts
DELETED
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Thin client for the premium gateway.
|
|
3
|
-
*
|
|
4
|
-
* The premium tools do not run in this package any more. Their bodies live on
|
|
5
|
-
* the gateway, which checks a Polar licence key before it does any work, so
|
|
6
|
-
* deleting anything here buys nothing: the answer only exists behind the gate.
|
|
7
|
-
*
|
|
8
|
-
* Set `MCP_LICENSE_KEY` to a Polar licence key. `MCP_GATEWAY_URL` overrides the
|
|
9
|
-
* endpoint, which is only useful for testing.
|
|
10
|
-
*/
|
|
11
|
-
/** Raised when a premium call cannot be completed. `message` is safe to show. */
|
|
12
|
-
export declare class GatewayError extends Error {
|
|
13
|
-
readonly refused: boolean;
|
|
14
|
-
constructor(message: string, refused: boolean);
|
|
15
|
-
}
|
|
16
|
-
export declare function premiumTool(tool: string, args: Record<string, unknown>): Promise<string>;
|
package/dist/gateway.js
DELETED
|
@@ -1,85 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Thin client for the premium gateway.
|
|
3
|
-
*
|
|
4
|
-
* The premium tools do not run in this package any more. Their bodies live on
|
|
5
|
-
* the gateway, which checks a Polar licence key before it does any work, so
|
|
6
|
-
* deleting anything here buys nothing: the answer only exists behind the gate.
|
|
7
|
-
*
|
|
8
|
-
* Set `MCP_LICENSE_KEY` to a Polar licence key. `MCP_GATEWAY_URL` overrides the
|
|
9
|
-
* endpoint, which is only useful for testing.
|
|
10
|
-
*/
|
|
11
|
-
const DEFAULT_GATEWAY_URL = 'https://mcp-gateway.contactae2000.workers.dev/mcp';
|
|
12
|
-
const DEFAULT_TIMEOUT_MS = 25000;
|
|
13
|
-
const USER_AGENT = 'mrfentmen-mcp/1.0';
|
|
14
|
-
/** Raised when a premium call cannot be completed. `message` is safe to show. */
|
|
15
|
-
export class GatewayError extends Error {
|
|
16
|
-
refused;
|
|
17
|
-
constructor(message, refused) {
|
|
18
|
-
super(message);
|
|
19
|
-
this.refused = refused;
|
|
20
|
-
this.name = 'GatewayError';
|
|
21
|
-
}
|
|
22
|
-
}
|
|
23
|
-
export async function premiumTool(tool, args) {
|
|
24
|
-
const key = (process.env.MCP_LICENSE_KEY ?? '').trim();
|
|
25
|
-
if (!key) {
|
|
26
|
-
throw new GatewayError(`"${tool}" is a premium tool and no licence key is set. Set MCP_LICENSE_KEY in your MCP client config.`, true);
|
|
27
|
-
}
|
|
28
|
-
const url = (process.env.MCP_GATEWAY_URL ?? DEFAULT_GATEWAY_URL).trim();
|
|
29
|
-
const controller = new AbortController();
|
|
30
|
-
const timer = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT_MS);
|
|
31
|
-
let response;
|
|
32
|
-
try {
|
|
33
|
-
response = await fetch(url, {
|
|
34
|
-
method: 'POST',
|
|
35
|
-
headers: {
|
|
36
|
-
'content-type': 'application/json',
|
|
37
|
-
accept: 'application/json',
|
|
38
|
-
'user-agent': USER_AGENT,
|
|
39
|
-
authorization: `Bearer ${key}`,
|
|
40
|
-
},
|
|
41
|
-
body: JSON.stringify({
|
|
42
|
-
jsonrpc: '2.0',
|
|
43
|
-
id: 1,
|
|
44
|
-
method: 'tools/call',
|
|
45
|
-
params: { name: tool, arguments: args },
|
|
46
|
-
}),
|
|
47
|
-
signal: controller.signal,
|
|
48
|
-
});
|
|
49
|
-
}
|
|
50
|
-
catch {
|
|
51
|
-
throw new GatewayError(`"${tool}" could not reach the licence gateway. Check your connection and try again.`, false);
|
|
52
|
-
}
|
|
53
|
-
finally {
|
|
54
|
-
clearTimeout(timer);
|
|
55
|
-
}
|
|
56
|
-
if (!response.ok) {
|
|
57
|
-
throw new GatewayError(`"${tool}" could not reach the licence gateway (HTTP ${response.status}).`, false);
|
|
58
|
-
}
|
|
59
|
-
let body;
|
|
60
|
-
try {
|
|
61
|
-
body = (await response.json());
|
|
62
|
-
}
|
|
63
|
-
catch {
|
|
64
|
-
throw new GatewayError(`"${tool}" got an unreadable answer from the licence gateway.`, false);
|
|
65
|
-
}
|
|
66
|
-
if (body.error) {
|
|
67
|
-
throw new GatewayError(`"${tool}" was refused by the licence gateway: ${body.error.message ?? 'unknown error'}`, false);
|
|
68
|
-
}
|
|
69
|
-
const result = body.result ?? {};
|
|
70
|
-
const text = (result.content ?? [])
|
|
71
|
-
.map((part) => part.text ?? '')
|
|
72
|
-
.join('\n')
|
|
73
|
-
.trim();
|
|
74
|
-
if (result.isError) {
|
|
75
|
-
// The gateway marks a licence refusal structurally, so a missing or rejected
|
|
76
|
-
// key is told apart from a tool that failed after the gate let it through.
|
|
77
|
-
if (result.structuredContent?.licenceRefusal) {
|
|
78
|
-
throw new GatewayError(text || `"${tool}" needs a valid licence key.`, true);
|
|
79
|
-
}
|
|
80
|
-
throw new GatewayError(text || `"${tool}" failed on the licence gateway.`, false);
|
|
81
|
-
}
|
|
82
|
-
if (!text)
|
|
83
|
-
throw new GatewayError(`"${tool}" returned no data.`, false);
|
|
84
|
-
return text;
|
|
85
|
-
}
|