@reliance_ltda/trilumi-mcp 0.0.0-stage → 2.2.0

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.
Files changed (3) hide show
  1. package/README.md +77 -2
  2. package/bin/trilumi-mcp.cjs +16437 -0
  3. package/package.json +24 -4
package/README.md CHANGED
@@ -1,3 +1,78 @@
1
- # Temporary Holding Version
1
+ # @reliance_ltda/trilumi-mcp
2
+
3
+ Model Context Protocol (MCP) server for Trilumi — family, student, activity, and wiki management.
4
+
5
+ ## Installation / Usage
6
+
7
+ You do not need to install this package permanently. You can run it directly with `npx`.
8
+
9
+ ### Environment Variables
10
+
11
+ | Variable | Description | Default |
12
+ |---|---|---|
13
+ | `TRILUMI_API_KEY` | **Required**. Your Trilumi family API Key. | — |
14
+ | `TRILUMI_BASE_URL` | Base URL of your Trilumi instance (e.g. `https://your-trilumi-instance.com`). | `https://local.trilumi.app` |
15
+
16
+ ---
17
+
18
+ ### Configuration for Claude Code / Antigravity / Cursor
19
+
20
+ Add the following to your MCP configuration file (`mcp_config.json` or `claude_desktop_config.json`):
21
+
22
+ ```json
23
+ {
24
+ "mcpServers": {
25
+ "trilumi": {
26
+ "command": "npx",
27
+ "args": ["-y", "@reliance_ltda/trilumi-mcp@latest"],
28
+ "env": {
29
+ "TRILUMI_API_KEY": "YOUR_TRILUMI_API_KEY",
30
+ "TRILUMI_BASE_URL": "https://your-trilumi-instance.com"
31
+ }
32
+ }
33
+ }
34
+ }
35
+ ```
36
+
37
+ ### Add via Claude Code CLI
38
+
39
+ ```bash
40
+ claude mcp add trilumi -e TRILUMI_API_KEY="YOUR_KEY" -e TRILUMI_BASE_URL="https://your-trilumi-instance.com" -- npx -y @reliance_ltda/trilumi-mcp@latest
41
+ ```
42
+
43
+ ---
44
+
45
+ ## 📊 Rich Markdown & Mermaid Diagrams Support
46
+
47
+ Trilumi natively renders interactive Mermaid diagrams across all Markdown editors, including:
48
+ - Activity descriptions (`create_activity`, `update_activity`)
49
+ - Activity comments (`create_activity_comment`, `update_activity_comment`)
50
+ - Student documentation and wiki pages (`create_page`, `update_page`)
51
+
52
+ Agents can generate diagrams by wrapping valid Mermaid code in standard fenced code blocks:
53
+
54
+ ````markdown
55
+ ```mermaid
56
+ graph TD
57
+ A[Client Request] --> B[Trilumi MCP Server]
58
+ B --> C[PostgreSQL Database]
59
+ B --> D[Real-time Events]
60
+ ```
61
+ ````
62
+
63
+ Supported diagram types include flowcharts (`graph` / `flowchart`), sequence diagrams (`sequenceDiagram`), class diagrams (`classDiagram`), state diagrams (`stateDiagram-v2`), ER diagrams (`erDiagram`), Gantt charts (`gantt`), pie charts (`pie`), git graphs (`gitGraph`), and mindmaps.
64
+
65
+ ---
66
+
67
+ ## 🧭 Family & Student Context
68
+
69
+ Call `get_family_context` early in a session to read the family's shared context (values, objectives, routines, and background) together with each student's description and profile. Agents should use it to ground planning, activity creation, and suggestions in the family's reality.
70
+
71
+ Guardians keep this current from **Settings → Family Context** and from each student's **Settings → General → Student Description**.
72
+
73
+ ---
74
+
75
+ ## License
76
+
77
+ MIT
2
78
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.