Skip to content

Commit 260e4df

Browse files
its-mashits-mash
committed
feat: add multi-transport variants for MCP server definitions
Split single server definitions into multiple variants based on transport/connection method and audience. Users can now choose between Remote HTTP (OAuth), Docker, npx, and self-hosted/enterprise options when installing a server. New variants added: - GitHub: Remote HTTP, Docker, Enterprise (GHES/GHEC) - Grafana: Self-Hosted, Cloud - Notion: Remote HTTP, npx, Docker - Sentry: Remote HTTP, npx, Self-Hosted - Supabase: Remote HTTP, npx - Playwright: npx, Docker - Slack: npx, Docker - Brave Search: npx, Docker - Exa Search: npx, Remote HTTP Total: 28 definitions (up from 16). All pass schema validation. Signed-off-by: Mohammod Al Amin Ashik <maa.ashik00@gmail.com>
1 parent beabc97 commit 260e4df

21 files changed

Lines changed: 819 additions & 31 deletions

servers/com.github-mcp.json renamed to servers/com.github-mcp-docker.json

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
{
22
"$schema": "../schemas/server-definition.schema.json",
3-
"id": "com.github-mcp",
4-
"name": "GitHub",
5-
"alias": "gh",
6-
"description": "Interact with GitHub repositories, issues, pull requests, actions, and code security through the official GitHub MCP server.",
3+
"id": "com.github-mcp-docker",
4+
"name": "GitHub (Docker)",
5+
"alias": "gh-docker",
6+
"description": "Interact with GitHub repositories, issues, pull requests, and code security via Docker container. Requires Docker installed.",
77
"icon": "https://avatars.githubusercontent.com/u/9919?v=4",
88
"schema_version": "2.1",
99
"categories": ["developer-tools", "version-control"],

‎servers/com.github-mcp-enterprise.json‎

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
{
2+
"$schema": "../schemas/server-definition.schema.json",
3+
"id": "com.github-mcp-enterprise",
4+
"name": "GitHub Enterprise",
5+
"alias": "gh-ent",
6+
"description": "Interact with GitHub Enterprise Server or GitHub Enterprise Cloud with Data Residency (ghe.com) via Docker container. For self-hosted GitHub instances.",
7+
"icon": "https://avatars.githubusercontent.com/u/9919?v=4",
8+
"schema_version": "2.1",
9+
"categories": ["developer-tools", "version-control"],
10+
"tags": ["git", "github", "enterprise", "ghes", "ghe", "self-hosted", "code", "issues", "pull-requests"],
11+
12+
"transport": {
13+
"type": "stdio",
14+
"command": "docker",
15+
"args": [
16+
"run", "-i", "--rm",
17+
"-e", "GITHUB_PERSONAL_ACCESS_TOKEN",
18+
"-e", "GITHUB_HOST",
19+
"ghcr.io/github/github-mcp-server"
20+
],
21+
"env": {
22+
"GITHUB_PERSONAL_ACCESS_TOKEN": "${input:GITHUB_TOKEN}",
23+
"GITHUB_HOST": "${input:GITHUB_HOST}"
24+
},
25+
"metadata": {
26+
"inputs": [
27+
{
28+
"id": "GITHUB_HOST",
29+
"label": "GitHub Enterprise Host URL",
30+
"description": "URL of your GitHub Enterprise instance. Include https:// prefix. For GHEC Data Residency use https://subdomain.ghe.com, for GHES use https://your-ghes-hostname.",
31+
"type": "url",
32+
"required": true,
33+
"secret": false,
34+
"placeholder": "https://github.mycompany.com",
35+
"obtain": {
36+
"instructions": "Enter the full URL of your GitHub Enterprise instance including the https:// protocol prefix.",
37+
"button_label": "Learn More"
38+
}
39+
},
40+
{
41+
"id": "GITHUB_TOKEN",
42+
"label": "GitHub Personal Access Token",
43+
"description": "Token used to authenticate with your GitHub Enterprise API. Requires repo and read:org scopes.",
44+
"type": "text",
45+
"required": true,
46+
"secret": true,
47+
"placeholder": "ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
48+
"obtain": {
49+
"instructions": "1. Go to your GitHub Enterprise instance\n2. Navigate to Settings > Developer settings > Personal access tokens\n3. Click 'Generate new token (classic)'\n4. Select scopes: repo, read:org\n5. Click 'Generate token'\n6. Copy the token (starts with ghp_)",
50+
"button_label": "Create Token"
51+
}
52+
}
53+
]
54+
}
55+
},
56+
57+
"auth": {
58+
"type": "api_key",
59+
"instructions": "Create a personal access token on your GitHub Enterprise instance with repo and read:org scopes"
60+
},
61+
62+
"contributor": {
63+
"name": "GitHub",
64+
"github": "github",
65+
"url": "https://github.com"
66+
},
67+
68+
"links": {
69+
"repository": "https://github.com/github/github-mcp-server",
70+
"homepage": "https://github.com/enterprise",
71+
"documentation": "https://github.com/github/github-mcp-server#github-enterprise-server"
72+
},
73+
74+
"platforms": ["all"],
75+
76+
"capabilities": {
77+
"tools": true,
78+
"resources": true,
79+
"prompts": true,
80+
"read_only_mode": false
81+
},
82+
83+
"changelog_url": "https://github.com/github/github-mcp-server/releases"
84+
}

‎servers/com.github-mcp-http.json‎

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
{
2+
"$schema": "../schemas/server-definition.schema.json",
3+
"id": "com.github-mcp-http",
4+
"name": "GitHub (Remote)",
5+
"alias": "gh",
6+
"description": "Interact with GitHub repositories, issues, pull requests, actions, and code security through GitHub's hosted remote MCP server. No local setup required.",
7+
"icon": "https://avatars.githubusercontent.com/u/9919?v=4",
8+
"schema_version": "2.1",
9+
"categories": ["developer-tools", "version-control"],
10+
"tags": ["git", "github", "code", "issues", "pull-requests", "repos", "actions", "code-review"],
11+
12+
"transport": {
13+
"type": "http",
14+
"url": "https://api.githubcopilot.com/mcp/",
15+
"metadata": {
16+
"inputs": []
17+
}
18+
},
19+
20+
"auth": {
21+
"type": "oauth",
22+
"instructions": "Authenticates via OAuth in your browser using your GitHub account. No token setup needed."
23+
},
24+
25+
"contributor": {
26+
"name": "GitHub",
27+
"github": "github",
28+
"url": "https://github.com"
29+
},
30+
31+
"links": {
32+
"repository": "https://github.com/github/github-mcp-server",
33+
"homepage": "https://github.com",
34+
"documentation": "https://github.com/github/github-mcp-server#readme"
35+
},
36+
37+
"platforms": ["all"],
38+
39+
"capabilities": {
40+
"tools": true,
41+
"resources": true,
42+
"prompts": true,
43+
"read_only_mode": false
44+
},
45+
46+
"changelog_url": "https://github.com/github/github-mcp-server/releases"
47+
}

‎servers/com.grafana-mcp-cloud.json‎

Lines changed: 94 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,94 @@
1+
{
2+
"$schema": "../schemas/server-definition.schema.json",
3+
"id": "com.grafana-mcp-cloud",
4+
"name": "Grafana Cloud",
5+
"alias": "grafana-cloud",
6+
"description": "Search dashboards, query Prometheus and Loki datasources, manage alerts, investigate incidents, and use Grafana Cloud features like Sift, OnCall, and Incidents.",
7+
"icon": "https://avatars.githubusercontent.com/u/7195757?v=4",
8+
"schema_version": "2.1",
9+
"categories": ["monitoring", "developer-tools"],
10+
"tags": ["grafana", "grafana-cloud", "monitoring", "dashboards", "prometheus", "loki", "alerts", "observability", "metrics", "incidents", "oncall"],
11+
12+
"transport": {
13+
"type": "stdio",
14+
"command": "docker",
15+
"args": [
16+
"run", "-i", "--rm",
17+
"-e", "GRAFANA_URL",
18+
"-e", "GRAFANA_SERVICE_ACCOUNT_TOKEN",
19+
"-e", "GRAFANA_ORG_ID",
20+
"grafana/mcp-grafana",
21+
"-t", "stdio"
22+
],
23+
"env": {
24+
"GRAFANA_URL": "${input:GRAFANA_URL}",
25+
"GRAFANA_SERVICE_ACCOUNT_TOKEN": "${input:GRAFANA_TOKEN}",
26+
"GRAFANA_ORG_ID": "${input:GRAFANA_ORG_ID}"
27+
},
28+
"metadata": {
29+
"inputs": [
30+
{
31+
"id": "GRAFANA_URL",
32+
"label": "Grafana Cloud URL",
33+
"description": "URL of your Grafana Cloud instance (e.g., https://myinstance.grafana.net).",
34+
"type": "url",
35+
"required": true,
36+
"secret": false,
37+
"placeholder": "https://myinstance.grafana.net"
38+
},
39+
{
40+
"id": "GRAFANA_TOKEN",
41+
"label": "Grafana Service Account Token",
42+
"description": "Service account token from your Grafana Cloud instance. Create one with the Editor role for full access.",
43+
"type": "text",
44+
"required": true,
45+
"secret": true,
46+
"placeholder": "glsa_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
47+
"obtain": {
48+
"url": "https://grafana.com/docs/grafana-cloud/account-management/authentication-and-permissions/service-accounts/",
49+
"instructions": "1. Log in to your Grafana Cloud instance\n2. Navigate to Administration > Service accounts\n3. Click 'Add service account'\n4. Assign the 'Editor' role\n5. Click 'Add service account token'\n6. Copy the generated token (starts with glsa_)",
50+
"button_label": "Learn More"
51+
}
52+
},
53+
{
54+
"id": "GRAFANA_ORG_ID",
55+
"label": "Grafana Organization ID",
56+
"description": "Organization ID for multi-org Grafana Cloud setups. Leave empty for single-org instances.",
57+
"type": "text",
58+
"required": false,
59+
"secret": false,
60+
"default": "1",
61+
"placeholder": "1"
62+
}
63+
]
64+
}
65+
},
66+
67+
"auth": {
68+
"type": "api_key",
69+
"instructions": "Create a service account token in your Grafana Cloud instance under Administration > Service accounts"
70+
},
71+
72+
"contributor": {
73+
"name": "Grafana Labs",
74+
"github": "grafana",
75+
"url": "https://grafana.com"
76+
},
77+
78+
"links": {
79+
"repository": "https://github.com/grafana/mcp-grafana",
80+
"homepage": "https://grafana.com/products/cloud/",
81+
"documentation": "https://github.com/grafana/mcp-grafana#readme"
82+
},
83+
84+
"platforms": ["all"],
85+
86+
"capabilities": {
87+
"tools": true,
88+
"resources": false,
89+
"prompts": false,
90+
"read_only_mode": false
91+
},
92+
93+
"changelog_url": "https://github.com/grafana/mcp-grafana/releases"
94+
}

servers/com.grafana-mcp.json renamed to servers/com.grafana-mcp-self-hosted.json

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
{
22
"$schema": "../schemas/server-definition.schema.json",
3-
"id": "com.grafana-mcp",
4-
"name": "Grafana",
3+
"id": "com.grafana-mcp-self-hosted",
4+
"name": "Grafana (Self-Hosted)",
55
"alias": "grafana",
6-
"description": "Search dashboards, query Prometheus and Loki datasources, manage alerts, and investigate incidents through the official Grafana MCP server.",
6+
"description": "Search dashboards, query Prometheus and Loki datasources, manage alerts, and investigate incidents on your self-hosted Grafana instance via Docker.",
77
"icon": "https://avatars.githubusercontent.com/u/7195757?v=4",
88
"schema_version": "2.1",
99
"categories": ["monitoring", "developer-tools"],

‎servers/com.notion-mcp-docker.json‎

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
{
2+
"$schema": "../schemas/server-definition.schema.json",
3+
"id": "com.notion-mcp-docker",
4+
"name": "Notion (Docker)",
5+
"alias": "notion-docker",
6+
"description": "Read and write Notion pages, databases, and blocks via Docker container. Uses a Notion integration token for authentication.",
7+
"icon": "https://avatars.githubusercontent.com/u/4792552?v=4",
8+
"schema_version": "2.1",
9+
"categories": ["productivity", "documentation"],
10+
"tags": ["notion", "notes", "wiki", "database", "pages", "blocks", "knowledge-base", "docker"],
11+
12+
"transport": {
13+
"type": "stdio",
14+
"command": "docker",
15+
"args": ["run", "--rm", "-i", "-e", "NOTION_TOKEN", "mcp/notion"],
16+
"env": {
17+
"NOTION_TOKEN": "${input:NOTION_TOKEN}"
18+
},
19+
"metadata": {
20+
"inputs": [
21+
{
22+
"id": "NOTION_TOKEN",
23+
"label": "Notion Integration Token",
24+
"description": "Internal integration secret token from Notion. Share the relevant pages/databases with your integration after creating it.",
25+
"type": "text",
26+
"required": true,
27+
"secret": true,
28+
"placeholder": "ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
29+
"obtain": {
30+
"url": "https://www.notion.so/profile/integrations",
31+
"instructions": "1. Go to notion.so/profile/integrations\n2. Click 'New integration'\n3. Give it a name and select your workspace\n4. Copy the Internal Integration Secret (starts with ntn_)\n5. Share desired pages/databases with the integration",
32+
"button_label": "Create Integration"
33+
}
34+
}
35+
]
36+
}
37+
},
38+
39+
"auth": {
40+
"type": "api_key",
41+
"instructions": "Create an integration at notion.so/profile/integrations and share pages with it"
42+
},
43+
44+
"contributor": {
45+
"name": "Notion",
46+
"github": "makenotion",
47+
"url": "https://notion.so"
48+
},
49+
50+
"links": {
51+
"repository": "https://github.com/makenotion/notion-mcp-server",
52+
"homepage": "https://notion.so",
53+
"documentation": "https://developers.notion.com"
54+
},
55+
56+
"platforms": ["all"],
57+
58+
"capabilities": {
59+
"tools": true,
60+
"resources": true,
61+
"prompts": false,
62+
"read_only_mode": false
63+
},
64+
65+
"changelog_url": "https://github.com/makenotion/notion-mcp-server/releases"
66+
}

‎servers/com.notion-mcp-http.json‎

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
{
2+
"$schema": "../schemas/server-definition.schema.json",
3+
"id": "com.notion-mcp-http",
4+
"name": "Notion (Remote)",
5+
"alias": "notion",
6+
"description": "Read and write Notion pages, databases, and blocks through Notion's hosted remote MCP server. No local setup required, authenticates via OAuth.",
7+
"icon": "https://avatars.githubusercontent.com/u/4792552?v=4",
8+
"schema_version": "2.1",
9+
"categories": ["productivity", "documentation"],
10+
"tags": ["notion", "notes", "wiki", "database", "pages", "blocks", "knowledge-base"],
11+
12+
"transport": {
13+
"type": "http",
14+
"url": "https://mcp.notion.com/mcp",
15+
"metadata": {
16+
"inputs": []
17+
}
18+
},
19+
20+
"auth": {
21+
"type": "oauth",
22+
"instructions": "Authenticates via OAuth 2.1 in your browser using your Notion account. No token setup needed."
23+
},
24+
25+
"contributor": {
26+
"name": "Notion",
27+
"github": "makenotion",
28+
"url": "https://notion.so"
29+
},
30+
31+
"links": {
32+
"repository": "https://github.com/makenotion/notion-mcp-server",
33+
"homepage": "https://notion.so",
34+
"documentation": "https://developers.notion.com/docs/mcp"
35+
},
36+
37+
"platforms": ["all"],
38+
39+
"capabilities": {
40+
"tools": true,
41+
"resources": true,
42+
"prompts": false,
43+
"read_only_mode": false
44+
},
45+
46+
"changelog_url": "https://github.com/makenotion/notion-mcp-server/releases"
47+
}

servers/com.notion-mcp.json renamed to servers/com.notion-mcp-npx.json

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
{
22
"$schema": "../schemas/server-definition.schema.json",
3-
"id": "com.notion-mcp",
4-
"name": "Notion",
5-
"alias": "notion",
6-
"description": "Read and write Notion pages, databases, blocks, and data sources through the official Notion MCP server.",
3+
"id": "com.notion-mcp-npx",
4+
"name": "Notion (npx)",
5+
"alias": "notion-npx",
6+
"description": "Read and write Notion pages, databases, and blocks locally via npx. Uses a Notion integration token for authentication.",
77
"icon": "https://avatars.githubusercontent.com/u/4792552?v=4",
88
"schema_version": "2.1",
99
"categories": ["productivity", "documentation"],

0 commit comments

Comments
 (0)