framedeck-mcp 2.0.1 → 2.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/LICENSE +21 -0
- package/README.md +43 -8
- package/glama.json +4 -0
- package/index.js +1179 -1118
- package/package.json +2 -2
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Framedeck
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -43,17 +43,41 @@ Set the environment variable `FRAMEDECK_API_KEY` and run:
|
|
|
43
43
|
npx framedeck-mcp
|
|
44
44
|
```
|
|
45
45
|
|
|
46
|
-
##
|
|
46
|
+
## Usage Examples
|
|
47
47
|
|
|
48
|
-
Talk to your AI assistant naturally:
|
|
48
|
+
Talk to your AI assistant naturally — here are three end-to-end workflows:
|
|
49
49
|
|
|
50
|
-
|
|
51
|
-
- *"The cooking tutorial is a go!"* — graduates it to a full production with stages
|
|
52
|
-
- *"Add tasks: write intro, record B-roll, find music"* — creates frames in your production
|
|
53
|
-
- *"Move the intro to Editing"* — updates your board in real-time
|
|
54
|
-
- *"How's my channel looking?"* — get a full overview with overdue items
|
|
50
|
+
### Example 1 — Capture and graduate ideas
|
|
55
51
|
|
|
56
|
-
|
|
52
|
+
> **You:** *"I just had 3 video ideas: a knife sharpening tutorial, a Sony A7IV review, and a day-in-the-life vlog. Add them to my idea pool."*
|
|
53
|
+
>
|
|
54
|
+
> **Claude (via MCP):** Calls `create_multiple_cards` with the three titles. They land in your Idea Pool's "Ideas" stage.
|
|
55
|
+
>
|
|
56
|
+
> **You:** *"The knife sharpening one is a go — graduate it to a real production."*
|
|
57
|
+
>
|
|
58
|
+
> **Claude:** Calls `graduate_to_production` which creates a new dedicated production with full stages (Idea → Scripting → Filming → Editing → Published) and moves the idea card across.
|
|
59
|
+
|
|
60
|
+
### Example 2 — Plan a production day
|
|
61
|
+
|
|
62
|
+
> **You:** *"For the Sony review, add subtasks: write intro, shoot product shots, record voiceover, edit B-roll, color grade, export final."*
|
|
63
|
+
>
|
|
64
|
+
> **Claude:** Calls `set_active_board` to "Sony A7IV review", then `create_multiple_cards` with all six subtasks in the "Filming" stage.
|
|
65
|
+
>
|
|
66
|
+
> **You:** *"Mark the intro and product shots as done."*
|
|
67
|
+
>
|
|
68
|
+
> **Claude:** Calls `move_card` twice to push them into the "Done" stage.
|
|
69
|
+
|
|
70
|
+
### Example 3 — Get a project overview
|
|
71
|
+
|
|
72
|
+
> **You:** *"How's my channel looking? Anything overdue?"*
|
|
73
|
+
>
|
|
74
|
+
> **Claude:** Calls `get_board_overview` for each production. Returns a summary showing card counts per stage, overdue items highlighted in red, and which productions need attention.
|
|
75
|
+
>
|
|
76
|
+
> **You:** *"What's assigned to me right now?"*
|
|
77
|
+
>
|
|
78
|
+
> **Claude:** Calls `get_my_cards` and lists everything you own grouped by board and status.
|
|
79
|
+
|
|
80
|
+
## Tools (32)
|
|
57
81
|
|
|
58
82
|
| Tool | Description |
|
|
59
83
|
|------|-------------|
|
|
@@ -103,6 +127,17 @@ The MCP server automatically uses the correct terminology based on each board's
|
|
|
103
127
|
|
|
104
128
|
When you add ideas without specifying a board, they automatically land in your **Idea Pool**. When an idea is ready, use `graduate_to_production` to create a dedicated production with full stages (Idea > Scripting > Filming > Editing > Published).
|
|
105
129
|
|
|
130
|
+
## Safety Annotations
|
|
131
|
+
|
|
132
|
+
Every tool ships with MCP safety annotations (`readOnlyHint`, `destructiveHint`, `idempotentHint`, `openWorldHint`) so AI clients can warn users before destructive actions like `delete_card`, `delete_column`, and `archive_card`.
|
|
133
|
+
|
|
134
|
+
## Privacy & Support
|
|
135
|
+
|
|
136
|
+
- **Privacy Policy:** https://framedeck.app/privacy
|
|
137
|
+
- **Terms of Service:** https://framedeck.app/terms
|
|
138
|
+
- **Support:** support@framedeck.app
|
|
139
|
+
- **Issues:** https://github.com/Lukaris/framedeck-mcp/issues
|
|
140
|
+
|
|
106
141
|
## License
|
|
107
142
|
|
|
108
143
|
MIT
|
package/glama.json
ADDED