Add Claude Code Plugin / Marketplace Support #55
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This adds support for Claude Code Plugin/Marketplace distribution as requested in issue perplexityai#52. - Creates .claude-plugin/marketplace.json with Perplexity MCP server plugin definition - Follows the standard marketplace structure used by Docker and other official plugins - Includes proper metadata, keywords, and categorization - References the plugin directory structure for easy installation
- Creates plugin.json with complete metadata for the Perplexity MCP server - Includes proper categorization, dependencies, and engine requirements - References MCP server configuration file - Follows Claude Code plugin standards
- Defines how to run the Perplexity MCP server using npx - Includes required environment variables for API key and timeout - Uses the official @perplexity-ai/mcp-server package - Sets reasonable default timeout of 5 minutes
- Provides comprehensive installation instructions for Claude Code - Documents all available tools and their use cases - Includes troubleshooting guide and support information - Follows Claude Code plugin documentation standards
- Add Claude Code Plugin marketplace as the recommended installation method - Provide step-by-step instructions for marketplace installation - Keep existing manual configuration options - Highlight the benefits of using the plugin system (automatic updates, easier management) - Maintain all existing documentation for other MCP clients
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Add Claude Code Plugin / Marketplace Support
Fixes #52
This PR implements Claude Code Plugin/Marketplace distribution support as requested in issue #52, enabling easy discovery and installation of the Perplexity MCP server through Claude Code's plugin system.
Changes Made
📁 Marketplace Configuration
.claude-plugin/marketplace.json- Main marketplace configuration defining the Perplexity plugin collection🔧 Plugin Structure
plugins/perplexity-mcp-server/.claude-plugin/plugin.json- Individual plugin manifest with complete metadataplugins/perplexity-mcp-server/.mcp.json- MCP server runtime configurationplugins/perplexity-mcp-server/README.md- Comprehensive plugin documentation📚 Documentation Updates
Installation Experience
Users can now easily install the Perplexity MCP server with just two commands:
Key Features
✅ Easy Discovery - Plugin discoverable through Claude Code marketplace system
✅ Automated Installation - Handles MCP server configuration automatically
✅ Proper Categorization - Classified as "ai-tools" with relevant keywords
✅ Environment Setup - Pre-configured with API key and timeout variables
✅ Comprehensive Documentation - Installation, usage, and troubleshooting guides
✅ Backward Compatible - Existing installation methods still work
Testing
The plugin structure follows Claude Code standards and includes:
Benefits
This implementation will:
Future Compatibility
Once merged, this repository can be listed on https://claudecodemarketplace.com by adding it to the marketplaces.json, making it discoverable to thousands of users automatically.
Ready for review! This PR addresses all requirements from issue #52 and follows established patterns from Docker's official Claude Code plugins.