SETUP INSTRUCTIONS MCP SERVER: CLAUDE AI

[dmdcreativestudio]

Pre-submission Checklist

• I have verified that this discussion would not be more appropriate as an issue in a specific repository
• I have searched existing discussions to avoid duplicates

Discussion Topic

GitHub + Veed.io MCP Server

An intelligent MCP (Model Context Protocol) server that combines GitHub's repository data with Veed.io's video editing platform. Create context-aware video projects using code, documentation, issues, and repository insights.

Features

• 🐙 Search GitHub repositories for relevant projects and code
• 💻 Search GitHub code across all public repositories
• 📄 Access repository content (README, docs, code files)
• 🐛 Search issues and PRs for project insights and discussions
• 🎬 Create context-aware video projects using GitHub search results
• 📝 Generate scripts from repository data (voiceover, subtitles, descriptions)
• 🎯 Smart project creation that combines code insights with video content
• 📋 Traditional project management - list, view, and manage Veed projects

Prerequisites

• Node.js 18+ installed
• GitHub account (Personal Access Token recommended for higher rate limits)
• Veed.io account with API access (optional for basic GitHub search)
• API keys/tokens for both services

Setup Instructions

1. Install Dependencies

npm install

2. Configure Environment Variables

Create a .env file in the project root:

GITHUB_TOKEN=your_github_personal_access_token_here
GITHUB_API_BASE_URL=https://api.github.com
VEED_API_KEY=your_veed_api_key_here
VEED_API_BASE_URL=https://api.veed.io/v1

Getting a GitHub Token:

1. Go to GitHub Settings → Developer settings → Personal access tokens
2. Generate new token (classic)
3. Select scopes: public_repo (or repo for private repos)
4. Copy the token to your .env file

Note: GitHub API works without a token but has lower rate limits. A token is recommended for production use.

3. Build the Server

npm run build

4. Test the Server

npm start

5. Configure with ChatGPT/Claude

Add to your MCP client configuration (e.g., ChatGPT desktop app):

{
  "mcpServers": {
    "github-veed": {
      "command": "node",
      "args": ["/path/to/github-veed-mcp-server/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "your_github_token_here",
        "VEED_API_KEY": "your_veed_api_key_here"
      }
    }
  }
}

Available Tools

🐙 GitHub Intelligence Tools

search_github_repositories

Search GitHub repositories for relevant projects and code

• query (required): Search query to find relevant repositories
• sort (optional): Sort by stars, forks, updated, or best-match (default: best-match)
• limit (optional): Max results to return (default: 5)
• language (optional): Filter by programming language (e.g., javascript, python)

search_github_code

Search for specific code snippets and files across GitHub

• query (required): Code search query
• language (optional): Programming language filter
• filename (optional): Search within specific filename
• repository (optional): Search within specific repository (owner/repo)
• limit (optional): Max results (default: 5)

get_repository_content

Get content from a specific GitHub repository file

• owner (required): Repository owner/organization
• repo (required): Repository name
• path (required): File path within repository
• ref (optional): Branch, tag, or commit SHA (default: main)

search_github_issues

Search GitHub issues and pull requests for project insights

• query (required): Search query for issues/PRs
• repository (optional): Search within specific repository (owner/repo)
• state (optional): Filter by open, closed, or all (default: all)
• limit (optional): Max results (default: 5)

create_project_with_github_context

Create a Veed.io project informed by GitHub search results

• title (required): Project title
• github_query (required): Query to search GitHub for relevant context
• search_type (optional): repositories, code, or issues (default: repositories)
• project_description (optional): Project description
• auto_generate_script (optional): Auto-generate script from GitHub content (default: true)
• script_type (optional): Type of script to generate (voiceover, subtitle, description)

add_github_based_script

Add an intelligent script to existing project using GitHub content

• project_id (required): Target project ID
• github_query (required): Query to search GitHub for script content
• search_type (optional): repositories, code, or issues (default: repositories)
• script_type (required): voiceover, subtitle, or description
• language (optional): Language code (default: 'en')
• max_length (optional): Maximum script length in words (default: 500)

🎬 Traditional Veed.io Tools

create_blank_project

Create a new blank video project in Veed.io

• title (required): Project title
• description (optional): Project description

list_projects

List all projects in your workspace

• limit (optional): Max results (default: 10)
• status (optional): Filter by status (active, completed, archived, all)

get_project_details

Get detailed information about a specific project

• project_id (required): Project ID to retrieve

Usage Examples

Once connected to your AI assistant, you can use powerful GitHub-driven workflows:

🐙 Developer-Focused Workflows

"Search GitHub for React tutorials and create a training video project"

"Find repositories about machine learning and create a demo video with auto-generated script"

"Search for JavaScript best practices and add a voiceover script to project abc123"

"Create a video project about 'API Development' using popular GitHub repositories"

📚 Documentation & Learning

"Search GitHub issues about 'authentication bugs' and create an educational video"

"Find code examples for 'GraphQL implementation' and create a tutorial project"

"Get the README from facebook/react and create a project overview video"

"Search for 'Docker tutorials' code and add subtitles to project xyz789"

🚀 Project Showcases

"Create a project showcase video using the top React repositories"

"Find my organization's repositories and create an internal training video"

"Search for 'open source contributions' and create a developer recruitment video"

"Add a script about our latest GitHub releases to project abc123"

🎬 Traditional Video Workflows

"Create a blank project called 'Developer Onboarding'"

"List all my active video projects"

"Get details for project abc123"

API Requirements

GitHub Setup

Free tier available! GitHub API works without authentication but has rate limits:

• Unauthenticated: 60 requests/hour
• With Personal Access Token: 5,000 requests/hour

To create a GitHub token:

1. Go to GitHub.com → Settings → Developer settings → Personal access tokens
2. Generate new token (classic)
3. Select scopes: public_repo (or repo for private repository access)
4. Copy token and add to your .env file

Veed.io Setup (Optional)

For video creation features, you'll need Veed.io API access:

1. Enable API access on your Veed.io account
2. Generate an API key
3. Add it to your environment variables

Note: You can use all GitHub search features without Veed.io API access.I access.

Development

Run in Development Mode

npm run dev

Lint Code

npm run lint

Project Structure

veed-mcp-server/
├── src/
│   └── index.ts          # Main MCP server implementation
├── dist/                 # Compiled JavaScript output
├── package.json          # Dependencies and scripts
├── tsconfig.json         # TypeScript configuration
└── README.md            # This file

Error Handling

The server includes comprehensive error handling for:

• Missing API credentials
• Invalid project IDs
• Network connection issues
• Veed.io API errors
• Invalid script formats

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

License

MIT License - see LICENSE file for details

Support

For issues related to:

• MCP Server: Open an issue in this repository
• Veed.io API: Contact Veed.io support
• AI Assistant Integration: Check your AI client documentation