Skip to content

MARKETPLACE_CHECKLIST.md

Latest commit

 

History

History
185 lines (147 loc) · 4.9 KB

MARKETPLACE_CHECKLIST.md

File metadata and controls

185 lines (147 loc) · 4.9 KB

Marketplace Submission Checklist

Repository Setup ✅

  • Private GitHub repository created: bjoernbethge/mcp-code-execution
  • All essential files committed
  • .gitignore configured for sensitive data
  • Repository is ready for testing

Required Files for Marketplace ✅

Core Plugin Files

  • plugin.json - Plugin manifest (Claude Code compatible)

    • Defines commands, agents, hooks, skills, configuration
    • Single source of truth for plugin definition

  • README.md - User-facing documentation

    • Quick start guide
    • Usage examples
    • Best practices
    • Troubleshooting

  • CHANGELOG.md - Version history

    • Tracks changes between versions
    • Important for updates

  • LICENSE - MIT License

    • Required for marketplace

  • CLAUDE.md - Developer guidelines

    • Internal documentation
    • Patterns and best practices
    • Development workflow

Plugin Implementation

  • plugin/commands/ - Slash commands

    • setupMCP.ts
    • generateWrappers.ts
    • listSkills.ts
    • createSkill.ts
    • validateConfig.ts

  • plugin/agents/ - Autonomous agents

    • taskExecutor.ts

  • plugin/hooks/ - Lifecycle hooks

    • onTaskStart.ts
    • onTaskComplete.ts
    • onError.ts

  • plugin/config/ - Default configuration

    • default-config.json

Client Libraries

  • client/python.py - Python MCP client
  • client/typescript.ts - TypeScript MCP client
  • client/retry.py - Retry logic
  • client/security.py - Security policies
  • client/monitoring.py - Performance monitoring

Skills & Examples

  • skills/python/ - Python skills

    • extract_action_items.py
    • example_data_filter.py

  • skills/typescript/ - TypeScript skills

    • exampleDataFilter.ts

  • example_task.py - Reference implementation

Configuration Files

  • mcp_config.json - MCP server configuration template
  • pyproject.toml - Python project config
  • package.json - TypeScript project config
  • tsconfig.json - TypeScript compiler config

Marketplace-Ready Checklist

Plugin Manifest

  • Valid JSON schema
  • Proper $schema reference: https://docs.claude.com/schemas/plugin-manifest.json
  • All required fields present
  • Commands properly defined
  • Agents properly defined
  • Hooks properly defined
  • Configuration schema valid
  • Dependencies documented

Documentation Quality

  • README is clear and complete
  • Quick start instructions provided
  • Usage examples included
  • Best practices documented
  • Troubleshooting section present
  • API documentation available

Code Quality

  • Proper error handling
  • Type hints in Python
  • TypeScript with proper typing
  • Security best practices followed
  • Monitoring/logging implemented

Repository Status

  • Git repository initialized
  • Initial commit created
  • Remote pushed to GitHub
  • Private repository (testing only)
  • Ready for marketplace submission

Next Steps

Before Marketplace Testing

  1. Install plugin locally and test all commands
  2. Verify MCP server integration works
  3. Test Python and TypeScript execution
  4. Validate error handling
  5. Check token efficiency metrics

For Public Release

  1. Change repository to public
  2. Add repository URL to plugin.json
  3. Update author information if needed
  4. Create GitHub releases for versions
  5. Submit to Claude Code Marketplace

Testing the Plugin Locally

Install from Git

# Clone the private repo
git clone https://github.com/bjoernbethge/mcp-code-execution.git

# Or install via Claude Code
# In Claude Code, use the GitHub URL

Test Commands

/setup-mcp              # Initialize workspace
/generate-wrappers      # Generate MCP wrappers
/list-skills            # List registered skills
/create-skill           # Create new skill
/validate-config        # Validate MCP configuration

Test Agents

  • Verify task executor runs Python code
  • Verify TypeScript execution works
  • Check token efficiency

Marketplace Submission

When Ready

  1. Make repository public
  2. Submit to: https://claude.com/marketplace
  3. Include:
    • Repository URL
    • Plugin description
    • Screenshots (if applicable)
    • Usage examples

Metadata

  • Name: MCP Code Execution
  • Category: code-execution
  • Tags: mcp, automation, code, token-efficiency, python, typescript
  • License: MIT
  • Author: Anthropic

Current Status

✅ Plugin Validation Passed

  • Repository: https://github.com/bjoernbethge/mcp-code-execution (private)
  • Plugin Manifest: .claude-plugin/plugin.json
  • Validation: PASSED ✔️ (claude plugin validate)
  • Commits: 3
    1. Initial commit (37 files)
    2. Marketplace checklist
    3. Plugin structure fixes & validation
  • Status: Ready for testing with Claude Code

Last updated: 2025-11-08