@fullstackcraftllc/codevideo-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 CodeVideo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# codevideo-mcp
+
+The MCP server for CodeVideo. 
+
+Create software educational content using natural language.
+
+## Examples:
+
+Creation:
+- "Build a video lesson on how to use the `useState` hook in React"
+- "Can you create a video lesson compare and contrasting how to program concurrently in C#, Go, and Rust?"
+- Can you give me a markdown blog post on how to use the `useState` hook in React?"
+
+Conversion:
+- "Please convert these CodeVideo JSON actions to a video"
+- "Convert these CodeVideo JSON actions to a blog post"
+- "Convert these CodeVideo JSON actions to HTML"
+
+Validation:
+- "Are these CodeVideo JSON actions valid?"
+
+## Usage with Claude Desktop
+
+Simply drop the following into your `claude_desktop_config.json` file:
+
+```json
+{
+    // ... other MCP servers
+    "codevideo-mcp": {
+        "command": "npx",
+        "args": [
+            "-y",
+            "@fullstackcraftllc/codevideo-mcp@latest"
+        ],
+        "env": {
+            "ELEVENLABS_API_KEY": "your-elevenlabs-api-key",
+            "ELEVENLABS_VOICE_ID": "your-elevenlabs-voice-id"
+        }
+    },
+    // ... other MCP servers
+}
+```
+
+Be sure to restart Claude after modifying this config! 
+
+After restarting Claude Desktop, if installation was successful, you should see `codevideo-mcp` in the list of installed MCPs:
+
+![codevideo-mnp successfully installed in Claude Desktop](./codevideo-mcp-installed.png)
+
+## Local Development
+
+Clone this repository:
+
+```shell
+git clone https://github.com/codevideo/codevideo-mcp.git
+```
+
+Then, install the dependencies and build the project:
+
+```shell
+cd codevideo-mcp
+npm install
+npm run build
+```
+
+Then, use the following JSON to run the local version on your Claude Desktop:
+
+```json
+    // ... other MCP servers
+    "codevideo-mcp": {
+        "command": "npx",
+        "args": [
+            "tsx",
+            "/path/to/your/clone/of/codevideo-mcp/src/index.ts"
+        ],
+        "env": {
+            "PATH_TO_CODEVIDEO_CLI": "/path/to/your/codevideo-cli",
+        }
+    }
+    // ... other MCP servers
+```
+
+## Known Issues
+
+- Currently, creating entire courses seems to be a bit flakey and perhaps too large for the context window for Claude. We're working on refining the full course flow. Single lesson generation seems to work well.