@idea-matrix/mcp 0.1.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.
- package/README.md +63 -0
- package/dist/cli.js +43670 -0
- package/manifest.json +61 -0
- package/package.json +44 -0
package/README.md
ADDED
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# Idea Matrix for Claude (MCP server and CLI)
|
|
2
|
+
|
|
3
|
+
Lets Claude Desktop, Claude Code, or any assistant that speaks the Model Context Protocol read and update your Idea Matrix file. It runs on your computer, works on the same file as the app, and applies the same rules: Confidence cannot rise without evidence, and nothing is ever deleted.
|
|
4
|
+
|
|
5
|
+
Nothing here talks to any server of ours. The only thing that leaves your machine is what your assistant sends to its own provider, on your account.
|
|
6
|
+
|
|
7
|
+
## Claude Desktop
|
|
8
|
+
|
|
9
|
+
1. Download `idea-matrix.mcpb` from the releases page.
|
|
10
|
+
2. Double-click it (or drag it into Claude Desktop → Settings → Extensions).
|
|
11
|
+
3. When asked, pick your matrix file, usually `ideas.ideamatrix.json`, the one the app created.
|
|
12
|
+
|
|
13
|
+
Then, in a chat, choose the **Work on my idea matrix** prompt, or just say "show me my idea matrix".
|
|
14
|
+
|
|
15
|
+
## Claude Code
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
claude mcp add idea-matrix -- npx -y @idea-matrix/mcp mcp --file ~/Documents/ideas.ideamatrix.json
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
Then `/idea-matrix:idea_matrix` lists your ideas and asks which to work on, or ask in plain words.
|
|
22
|
+
|
|
23
|
+
## Other MCP clients
|
|
24
|
+
|
|
25
|
+
Point the client at this command (stdio transport):
|
|
26
|
+
|
|
27
|
+
```
|
|
28
|
+
npx -y @idea-matrix/mcp mcp --file /path/to/ideas.ideamatrix.json
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Local models work the same way through a client that supports MCP, such as LM Studio or Open WebUI, pointed at a model in Ollama.
|
|
32
|
+
|
|
33
|
+
## What Claude can do
|
|
34
|
+
|
|
35
|
+
| Tool | What it does |
|
|
36
|
+
| --------------------------- | --------------------------------------------------------------------------- |
|
|
37
|
+
| `list_ideas` | The matrix with scores, Confidence, Potential and Score, sorted by Score |
|
|
38
|
+
| `get_idea` | One idea in full, including its evidence log and how high Confidence may go |
|
|
39
|
+
| `add_idea` | A new idea at Backlog, unscored |
|
|
40
|
+
| `update_idea` | Change text, stage, scores or Confidence. The Confidence gate applies |
|
|
41
|
+
| `add_evidence` | Record a conversation: who, what they currently do, any commitment |
|
|
42
|
+
| `park_idea` / `unpark_idea` | Set aside with a reason, or bring back |
|
|
43
|
+
|
|
44
|
+
Two prompts: **idea_matrix** lists the ideas as a numbered list, asks which one to work on (by number, name or id), then runs the scoring conversation (summarise, ask the one or two questions that matter, propose scores with reasons, write only what is agreed); **review_matrix** gives an honest read of the whole matrix without changing anything.
|
|
45
|
+
|
|
46
|
+
One resource, `ideamatrix://matrix`, is the whole matrix as Markdown.
|
|
47
|
+
|
|
48
|
+
## The command line
|
|
49
|
+
|
|
50
|
+
The same package is a small CLI:
|
|
51
|
+
|
|
52
|
+
```
|
|
53
|
+
idea-matrix list --file ideas.ideamatrix.json
|
|
54
|
+
idea-matrix show --file ideas.ideamatrix.json "Trailhead weather board"
|
|
55
|
+
idea-matrix export --file ideas.ideamatrix.json md > ideas.md
|
|
56
|
+
idea-matrix init --file ideas.ideamatrix.json
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
`IDEA_MATRIX_FILE` in the environment saves typing `--file`.
|
|
60
|
+
|
|
61
|
+
## Two programs, one file
|
|
62
|
+
|
|
63
|
+
The app and this server both write the same file. The app notices a change on disk within a few seconds and reloads, so scores set from Claude appear in the browser tab. Each write is atomic. If both write in the same second, the later one wins; keep one of them idle while the other is busy.
|