Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 49 additions & 0 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
{
"name": "perplexity-mcp-server",
"owner": {
"name": "Perplexity AI",
"email": "[email protected]"
},
"metadata": {
"description": "Official Perplexity AI plugin providing real-time web search, reasoning, and research capabilities",
"version": "0.4.0"
},
"plugins": [
{
"name": "perplexity",
"source": "./",
"description": "Real-time web search, reasoning, and research through Perplexity's API",
"version": "0.4.0",
"author": {
"name": "Perplexity AI",
"email": "[email protected]"
},
"homepage": "https://docs.perplexity.ai/guides/mcp-server",
"repository": "https://github.com/perplexityai/modelcontextprotocol",
"license": "MIT",
"keywords": [
"mcp",
"search",
"web-search",
"perplexity",
"research",
"reasoning",
"ai"
],
"category": "productivity",
"strict": false,
"mcpServers": {
"perplexity": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@perplexity-ai/mcp-server"],
"env": {
"PERPLEXITY_API_KEY": "${PERPLEXITY_API_KEY}",
"PERPLEXITY_TIMEOUT_MS": "${PERPLEXITY_TIMEOUT_MS:-600000}"
}
}
}
}
]
}

46 changes: 46 additions & 0 deletions .github/workflows/validate-plugin.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
name: Validate Plugin Configuration

on:
pull_request:
paths:
- '.claude-plugin/**'
- 'package.json'
push:
branches: [main]
paths:
- '.claude-plugin/**'
- 'package.json'

jobs:
validate:
runs-on: ubuntu-latest

steps:
- name: Checkout code
uses: actions/checkout@v4

- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: '20'

- name: Install Claude CLI
run: npm install -g @anthropic-ai/claude-code

- name: Validate Plugin Configuration
run: claude plugin validate .

- name: Check Plugin Files Exist
run: |
if [ ! -f ".claude-plugin/marketplace.json" ]; then
echo "Error: .claude-plugin/marketplace.json not found"
exit 1
fi
echo "✓ Marketplace file exists"

- name: Validate JSON Syntax
run: |
echo "Validating marketplace.json syntax..."
cat .claude-plugin/marketplace.json | jq empty
echo "✓ JSON syntax is valid"

19 changes: 19 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,25 @@ Advanced reasoning and problem-solving using the `sonar-reasoning-pro` model. Pe

### Claude Code

#### Option 1: Install via Plugin (Recommended)

The easiest way to get started with Perplexity in Claude Code:

```bash
# Add the Perplexity marketplace
/plugin marketplace add perplexityai/modelcontextprotocol

# Install the plugin
/plugin install perplexity
```

Then set your API key:
```bash
export PERPLEXITY_API_KEY="your_key_here"
```

#### Option 2: Manual Configuration

Run in your terminal:

```bash
Expand Down
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

5 changes: 3 additions & 2 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@perplexity-ai/mcp-server",
"version": "0.3.1",
"version": "0.4.0",
"mcpName": "io.github.perplexityai/mcp-server",
"description": "Real-time web search, reasoning, and research through Perplexity's API",
"keywords": [
Expand Down Expand Up @@ -29,7 +29,8 @@
},
"files": [
"dist",
"README.md"
"README.md",
".claude-plugin"
],
"scripts": {
"build": "tsc && shx chmod +x dist/*.js",
Expand Down
4 changes: 2 additions & 2 deletions server.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,12 +3,12 @@
"name": "io.github.perplexityai/mcp-server",
"title": "Perplexity API Platform",
"description": "Real-time web search, reasoning, and research through Perplexity's API",
"version": "0.3.1",
"version": "0.4.0",
"packages": [
{
"registryType": "npm",
"identifier": "@perplexity-ai/mcp-server",
"version": "0.3.1",
"version": "0.4.0",
"transport": {
"type": "stdio"
}
Expand Down