Skip to content

Commit d1461ed

Browse files
author
Mohammod Al Amin Ashik
committed
init
1 parent 7c3dbcd commit d1461ed

37 files changed

Lines changed: 796 additions & 2047 deletions

‎examples/complete-example.json‎

Lines changed: 36 additions & 66 deletions
Original file line numberDiff line numberDiff line change
@@ -1,97 +1,67 @@
11
{
22
"$schema": "../schemas/server-definition.schema.json",
3-
"id": "com.example.complete-server",
4-
"name": "Complete Example Server",
5-
"alias": "example",
6-
"description": "A fully-featured example demonstrating all available server definition fields",
7-
"icon": "🚀",
3+
"id": "com.anthropic-github",
4+
"name": "GitHub",
5+
"alias": "gh",
6+
"description": "Interact with GitHub repositories, issues, pull requests, and more through the GitHub API.",
7+
"icon": "🐙",
88
"schema_version": "2.1",
9-
"categories": ["developer-tools", "productivity"],
10-
"tags": ["example", "demo", "complete", "featured"],
11-
9+
"categories": ["developer-tools", "version-control"],
10+
"tags": ["git", "code", "issues", "pr", "repos"],
11+
1212
"transport": {
1313
"type": "stdio",
14-
"command": "npx",
15-
"args": ["-y", "@example/mcp-server"],
16-
"cwd": "~/.mcp-servers/example",
14+
"command": "docker",
15+
"args": [
16+
"run", "-i", "--rm", "-e",
17+
"GITHUB_PERSONAL_ACCESS_TOKEN",
18+
"ghcr.io/github/github-mcp-server"
19+
],
1720
"env": {
18-
"API_KEY": "${input:API_KEY}",
19-
"LOG_LEVEL": "info"
21+
"GITHUB_PERSONAL_ACCESS_TOKEN": "${input:GITHUB_TOKEN}"
2022
},
2123
"metadata": {
2224
"inputs": [
2325
{
24-
"id": "API_KEY",
25-
"label": "API Key",
26-
"description": "Your Example service API key for authentication",
26+
"id": "GITHUB_TOKEN",
27+
"label": "GitHub Personal Access Token",
28+
"description": "Token used to authenticate with GitHub API",
2729
"type": "password",
2830
"required": true,
2931
"secret": true,
30-
"placeholder": "ex_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
32+
"placeholder": "ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
3133
"obtain": {
32-
"url": "https://example.com/api/keys",
33-
"instructions": "1. Log in to your Example account\n2. Navigate to Settings > API Keys\n3. Click 'Create New Key'\n4. Give it a name (e.g., 'McpMux Access')\n5. Copy the generated key",
34-
"button_label": "Get API Key"
34+
"url": "https://github.com/settings/tokens/new",
35+
"instructions": "1. Click 'Generate new token (classic)'\n2. Give it a name like 'McpMux'\n3. Select scopes: repo, read:org\n4. Click 'Generate token'\n5. Copy the token (starts with ghp_)",
36+
"button_label": "Create Token"
3537
}
3638
}
3739
]
3840
}
3941
},
40-
42+
4143
"auth": {
4244
"type": "api_key",
43-
"instructions": "Requires an API key from example.com. Free tier available with 1000 requests/month."
45+
"instructions": "Create a token at https://github.com/settings/tokens with repo scope"
4446
},
45-
46-
"publisher": {
47-
"name": "Example Inc.",
48-
"domain": "example.com",
49-
"url": "https://example.com",
50-
"verified": true,
51-
"domain_verified": true,
52-
"official": true
47+
48+
"contributor": {
49+
"name": "Model Context Protocol",
50+
"github": "modelcontextprotocol",
51+
"url": "https://modelcontextprotocol.io"
5352
},
54-
53+
5554
"links": {
56-
"repository": "https://github.com/example/mcp-server",
57-
"homepage": "https://example.com/mcp",
58-
"documentation": "https://docs.example.com/mcp-server"
55+
"repository": "https://github.com/modelcontextprotocol/servers",
56+
"documentation": "https://modelcontextprotocol.io/docs"
5957
},
60-
58+
6159
"platforms": ["all"],
62-
60+
6361
"capabilities": {
6462
"tools": true,
6563
"resources": true,
66-
"prompts": true,
64+
"prompts": false,
6765
"read_only_mode": false
68-
},
69-
70-
"badges": ["official", "verified", "featured"],
71-
72-
"hosting_type": "local",
73-
74-
"license": "MIT",
75-
"license_url": "https://github.com/example/mcp-server/blob/main/LICENSE",
76-
77-
"installation": {
78-
"difficulty": "moderate",
79-
"prerequisites": [
80-
"Node.js 18+",
81-
"npm or npx"
82-
],
83-
"estimated_time": "5 minutes"
84-
},
85-
86-
"media": {
87-
"screenshots": [
88-
"https://example.com/assets/mcp-demo-1.png",
89-
"https://example.com/assets/mcp-demo-2.png",
90-
"https://example.com/assets/mcp-demo-3.png"
91-
],
92-
"demo_video": "https://youtube.com/watch?v=example123",
93-
"banner": "https://example.com/assets/mcp-banner.png"
94-
},
95-
96-
"changelog_url": "https://github.com/example/mcp-server/releases"
66+
}
9767
}

‎examples/read-only-example.json‎

Lines changed: 22 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -1,71 +1,43 @@
11
{
22
"$schema": "../schemas/server-definition.schema.json",
3-
"id": "com.example.docs-search",
4-
"name": "Documentation Search",
5-
"alias": "docsearch",
6-
"description": "Search and browse technical documentation with AI-powered semantic search (Read-Only)",
7-
"icon": "📖",
3+
"id": "com.cloudflare-docs",
4+
"name": "Cloudflare Docs",
5+
"alias": "cfdocs",
6+
"description": "Search and browse Cloudflare documentation",
7+
"icon": "📚",
88
"schema_version": "2.1",
9-
"categories": ["documentation", "search"],
10-
"tags": ["docs", "documentation", "search", "knowledge-base", "read-only"],
11-
9+
"categories": ["documentation", "cloud"],
10+
"tags": ["cloudflare", "docs", "documentation", "search"],
11+
1212
"transport": {
1313
"type": "http",
14-
"url": "https://docs-api.example.com/mcp",
14+
"url": "https://docs.mcp.cloudflare.com/mcp",
1515
"metadata": {
1616
"inputs": []
1717
}
1818
},
19-
19+
2020
"auth": {
21-
"type": "optional_api_key",
22-
"instructions": "Optional API key for increased rate limits. Works without auth with reduced quotas."
21+
"type": "none"
2322
},
24-
25-
"publisher": {
26-
"name": "Example Documentation Team",
27-
"domain": "example.com",
28-
"url": "https://docs.example.com",
29-
"verified": true,
30-
"domain_verified": true,
31-
"official": true
23+
24+
"contributor": {
25+
"name": "Cloudflare",
26+
"github": "cloudflare",
27+
"url": "https://developers.cloudflare.com"
3228
},
33-
29+
3430
"links": {
35-
"homepage": "https://docs.example.com/mcp-server",
36-
"documentation": "https://docs.example.com/mcp-server/guide",
37-
"repository": "https://github.com/example/docs-search-mcp"
31+
"repository": "https://github.com/cloudflare/mcp-server-cloudflare",
32+
"documentation": "https://developers.cloudflare.com/mcp"
3833
},
39-
34+
4035
"platforms": ["all"],
41-
36+
4237
"capabilities": {
4338
"tools": true,
4439
"resources": true,
4540
"prompts": false,
4641
"read_only_mode": true
47-
},
48-
49-
"badges": ["official", "verified"],
50-
51-
"hosting_type": "remote",
52-
53-
"license": "MIT",
54-
"license_url": "https://github.com/example/docs-search-mcp/blob/main/LICENSE",
55-
56-
"installation": {
57-
"difficulty": "easy",
58-
"prerequisites": [],
59-
"estimated_time": "1 minute"
60-
},
61-
62-
"media": {
63-
"screenshots": [
64-
"https://docs.example.com/assets/search-results.png",
65-
"https://docs.example.com/assets/semantic-search.png"
66-
],
67-
"banner": "https://docs.example.com/assets/banner.png"
68-
},
69-
70-
"changelog_url": "https://github.com/example/docs-search-mcp/releases"
42+
}
7143
}

‎examples/remote-hosted-example.json‎

Lines changed: 24 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -1,77 +1,43 @@
11
{
22
"$schema": "../schemas/server-definition.schema.json",
3-
"id": "com.example.remote-hosted",
4-
"name": "Remote Hosted Server Example",
5-
"alias": "remote",
6-
"description": "Example of a remote/cloud-hosted MCP server accessible via HTTP",
7-
"icon": "☁️",
3+
"id": "com.atlassian-mcp",
4+
"name": "Atlassian (Jira & Confluence)",
5+
"alias": "atlassian",
6+
"description": "Interact with Jira issues and Confluence pages",
7+
"icon": "🔷",
88
"schema_version": "2.1",
9-
"categories": ["cloud", "api"],
10-
"tags": ["remote", "hosted", "http", "cloud"],
11-
9+
"categories": ["productivity", "developer-tools"],
10+
"tags": ["jira", "confluence", "atlassian", "issues", "wiki"],
11+
1212
"transport": {
1313
"type": "http",
14-
"url": "https://mcp.example.com/v1/endpoint",
14+
"url": "https://mcp.atlassian.com/v1/mcp",
1515
"metadata": {
16-
"inputs": [
17-
{
18-
"id": "WORKSPACE_ID",
19-
"label": "Workspace ID",
20-
"description": "Your workspace identifier",
21-
"type": "text",
22-
"required": true,
23-
"secret": false,
24-
"placeholder": "ws_abc123"
25-
}
26-
]
16+
"inputs": []
2717
}
2818
},
29-
19+
3020
"auth": {
31-
"type": "oauth",
32-
"instructions": "OAuth authentication with your Example account. Click 'Connect' to authorize."
21+
"type": "oauth"
3322
},
34-
35-
"publisher": {
36-
"name": "Example Cloud Services",
37-
"domain": "example.com",
38-
"url": "https://cloud.example.com",
39-
"verified": true,
40-
"domain_verified": true,
41-
"official": true
23+
24+
"contributor": {
25+
"name": "Atlassian",
26+
"github": "atlassian",
27+
"url": "https://developer.atlassian.com"
4228
},
43-
29+
4430
"links": {
45-
"homepage": "https://cloud.example.com/mcp",
46-
"documentation": "https://docs.example.com/mcp/getting-started"
31+
"homepage": "https://developer.atlassian.com/cloud/mcp",
32+
"documentation": "https://developer.atlassian.com/cloud/mcp/docs"
4733
},
48-
34+
4935
"platforms": ["all"],
50-
36+
5137
"capabilities": {
5238
"tools": true,
53-
"resources": true,
54-
"prompts": false,
39+
"prompts": true,
40+
"resources": false,
5541
"read_only_mode": false
56-
},
57-
58-
"badges": ["official", "verified"],
59-
60-
"hosting_type": "remote",
61-
62-
"license": "Apache-2.0",
63-
"license_url": "https://www.apache.org/licenses/LICENSE-2.0",
64-
65-
"installation": {
66-
"difficulty": "easy",
67-
"prerequisites": [],
68-
"estimated_time": "2 minutes"
69-
},
70-
71-
"media": {
72-
"screenshots": [
73-
"https://example.com/assets/remote-server-ui.png"
74-
],
75-
"banner": "https://example.com/assets/cloud-banner.png"
7642
}
7743
}

0 commit comments

Comments
 (0)