@massteck/aloc-mcp-server 1.0.6 → 1.0.8
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 +43 -10
- package/config-schema.json +16 -0
- package/manifest.json +21 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -23,15 +23,33 @@ Official Model Context Protocol (MCP) server for **ALOC** (`@massteck/aloc-mcp-s
|
|
|
23
23
|
|
|
24
24
|
---
|
|
25
25
|
|
|
26
|
-
##
|
|
26
|
+
## Standard MCP Prompts
|
|
27
27
|
|
|
28
|
-
|
|
28
|
+
In addition to tools, the server registers standard pedagogical prompt templates:
|
|
29
|
+
|
|
30
|
+
| Prompt | Target Domain | Description |
|
|
31
|
+
| :--- | :---: | :--- |
|
|
32
|
+
| `aloc_socratic_tutor` | Socratic Pedagogy | Guides LLMs to retrieve questions and provide progressive hints without spoiling answers. |
|
|
33
|
+
| `aloc_exam_revision_planner` | Curriculum Planning | Analyzes syllabus topic hierarchies and Bloom difficulty to compile structured study timetables. |
|
|
34
|
+
| `aloc_bloom_evaluator` | Psychometrics | Evaluates cognitive complexity and diagnoses underlying student misconceptions. |
|
|
35
|
+
|
|
36
|
+
---
|
|
37
|
+
|
|
38
|
+
## Quickstart & Installation
|
|
39
|
+
|
|
40
|
+
### Option A: 1-Click Install via Smithery.ai (Claude Desktop)
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
npx -y @smithery/cli install @massteck/aloc-mcp-server --client claude
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
### Option B: Manual Installation
|
|
29
47
|
|
|
30
48
|
```bash
|
|
31
49
|
npm install -g @massteck/aloc-mcp-server
|
|
32
50
|
```
|
|
33
51
|
|
|
34
|
-
###
|
|
52
|
+
### 1. Configuration (Claude Desktop)
|
|
35
53
|
|
|
36
54
|
Add the following to your `claude_desktop_config.json`:
|
|
37
55
|
|
|
@@ -50,7 +68,7 @@ Add the following to your `claude_desktop_config.json`:
|
|
|
50
68
|
}
|
|
51
69
|
```
|
|
52
70
|
|
|
53
|
-
###
|
|
71
|
+
### 2. Configuration (Cursor IDE)
|
|
54
72
|
|
|
55
73
|
Add the following to your `.cursor/mcp.json`:
|
|
56
74
|
|
|
@@ -71,13 +89,28 @@ Add the following to your `.cursor/mcp.json`:
|
|
|
71
89
|
|
|
72
90
|
---
|
|
73
91
|
|
|
74
|
-
##
|
|
92
|
+
## Cursor IDE Integration (`.cursorrules`)
|
|
93
|
+
|
|
94
|
+
Drop a `.cursorrules` file into your project root:
|
|
95
|
+
|
|
96
|
+
```markdown
|
|
97
|
+
# .cursorrules — ALOC Assessment Infrastructure Assistant
|
|
98
|
+
|
|
99
|
+
You are an expert full-stack EdTech engineer building on ALOC Station (https://aloc.com.ng).
|
|
100
|
+
|
|
101
|
+
## Best Practices
|
|
102
|
+
1. Assessment Generation: Use 'aloc_generate_assessment' with official presets ('jamb_standard_40', 'waec_standard_50', 'micro_test_10') instead of raw single-question loops.
|
|
103
|
+
2. Anti-Cheating: Always pass 'shuffleOptions: true' and unique deterministic seeds ('seed') when creating candidate sitting mock tests.
|
|
104
|
+
3. Socratic Tutoring: When helping students, use 'aloc_get_question_explanation' to extract misconception hints rather than immediately revealing correct answer keys.
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
## Authentication & Quota Metering
|
|
75
110
|
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
3. Deducts metered credits matching the ALOC pricing tiers.
|
|
80
|
-
4. Enforces request limits (maximum 20 items per search) to prevent bulk harvesting.
|
|
111
|
+
- **API Key Security**: Tool invocations authenticate via your `ALOC_API_KEY` passed in the MCP server environment.
|
|
112
|
+
- **Transparent Metering**: Tool executions consume standard API credits matching ALOC tier rates (Discovery tools are free 0-credit, assessment generation is 1 credit, L3 step-by-step reasoning is 10 credits).
|
|
113
|
+
- **Agent Analytics**: Automatic agent telemetry (`X-Client-Type: mcp`) logs tool usage in your Developer Dashboard for real-time cost and volume tracking.
|
|
81
114
|
|
|
82
115
|
---
|
|
83
116
|
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3
|
+
"type": "object",
|
|
4
|
+
"required": ["apiKey"],
|
|
5
|
+
"properties": {
|
|
6
|
+
"apiKey": {
|
|
7
|
+
"type": "string",
|
|
8
|
+
"description": "Your ALOC live or sandbox API key (obtain from https://aloc.com.ng/dashboard/api-keys)"
|
|
9
|
+
},
|
|
10
|
+
"baseUrl": {
|
|
11
|
+
"type": "string",
|
|
12
|
+
"default": "https://dev.aloc.com.ng/api/v1",
|
|
13
|
+
"description": "ALOC Station API base URL"
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
}
|
package/manifest.json
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
{
|
|
2
|
+
"manifest_version": "0.2",
|
|
3
|
+
"name": "@massteck/aloc-mcp-server",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"description": "Official Model Context Protocol (MCP) Server for ALOC assessment content infrastructure",
|
|
6
|
+
"author": {
|
|
7
|
+
"name": "ALOC Infrastructure Team"
|
|
8
|
+
},
|
|
9
|
+
"server": {
|
|
10
|
+
"type": "node",
|
|
11
|
+
"entry_point": "dist/index.js",
|
|
12
|
+
"mcp_config": {
|
|
13
|
+
"command": "node",
|
|
14
|
+
"args": [
|
|
15
|
+
"${__dirname}/dist/index.js"
|
|
16
|
+
],
|
|
17
|
+
"env": {}
|
|
18
|
+
}
|
|
19
|
+
},
|
|
20
|
+
"license": "Proprietary"
|
|
21
|
+
}
|
package/package.json
CHANGED