mirror of
https://github.com/punkpeye/awesome-mcp-servers.git
synced 2026-03-12 04:05:17 +00:00
chore: automate parts of curation
This commit is contained in:
Frank Fiegel
356
.github/workflows/check-glama.yml
vendored
Normal file
356
.github/workflows/check-glama.yml
vendored
Normal file
@@ -0,0 +1,356 @@
|
|||||||
|
name: Check Glama Link
|
||||||
|
|
||||||
|
on:
|
||||||
|
pull_request_target:
|
||||||
|
types: [opened, edited, synchronize, closed]
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
contents: read
|
||||||
|
pull-requests: write
|
||||||
|
issues: write
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
# Post-merge welcome comment
|
||||||
|
welcome:
|
||||||
|
if: github.event.action == 'closed' && github.event.pull_request.merged == true
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- name: Post welcome comment
|
||||||
|
uses: actions/github-script@v7
|
||||||
|
with:
|
||||||
|
script: |
|
||||||
|
const { owner, repo } = context.repo;
|
||||||
|
const pr_number = context.payload.pull_request.number;
|
||||||
|
const marker = '<!-- welcome-comment -->';
|
||||||
|
|
||||||
|
const { data: comments } = await github.rest.issues.listComments({
|
||||||
|
owner,
|
||||||
|
repo,
|
||||||
|
issue_number: pr_number,
|
||||||
|
per_page: 100,
|
||||||
|
});
|
||||||
|
|
||||||
|
if (!comments.some(c => c.body.includes(marker))) {
|
||||||
|
await github.rest.issues.createComment({
|
||||||
|
owner,
|
||||||
|
repo,
|
||||||
|
issue_number: pr_number,
|
||||||
|
body: `${marker}\nThank you for your contribution! Your server has been merged.
|
||||||
|
|
||||||
|
Are you in the MCP [Discord](https://glama.ai/mcp/discord)? Let me know your Discord username and I will give you a **server-author** flair.
|
||||||
|
|
||||||
|
Also, make sure to claim your server on https://glama.ai/mcp/servers (click "Add Server" if it is not already there). Then update Dockerfile settings — this will make it available for anyone to use.
|
||||||
|
|
||||||
|
If you already have a remote server, you can list it under https://glama.ai/mcp/connectors`
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
# Validation checks (only on open PRs)
|
||||||
|
check-submission:
|
||||||
|
if: github.event.action != 'closed'
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- name: Checkout base branch
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
with:
|
||||||
|
ref: ${{ github.event.pull_request.base.ref }}
|
||||||
|
|
||||||
|
- name: Validate PR submission
|
||||||
|
uses: actions/github-script@v7
|
||||||
|
with:
|
||||||
|
script: |
|
||||||
|
const fs = require('fs');
|
||||||
|
const { owner, repo } = context.repo;
|
||||||
|
const pr_number = context.payload.pull_request.number;
|
||||||
|
|
||||||
|
// Read existing README to check for duplicates
|
||||||
|
const readme = fs.readFileSync('README.md', 'utf8');
|
||||||
|
const existingUrls = new Set();
|
||||||
|
const urlRegex = /\(https:\/\/github\.com\/[^)]+\)/gi;
|
||||||
|
for (const match of readme.matchAll(urlRegex)) {
|
||||||
|
existingUrls.add(match[0].toLowerCase());
|
||||||
|
}
|
||||||
|
|
||||||
|
// Get the PR diff
|
||||||
|
const { data: files } = await github.rest.pulls.listFiles({
|
||||||
|
owner,
|
||||||
|
repo,
|
||||||
|
pull_number: pr_number,
|
||||||
|
per_page: 100,
|
||||||
|
});
|
||||||
|
|
||||||
|
// Permitted emojis
|
||||||
|
const permittedEmojis = [
|
||||||
|
'\u{1F396}\uFE0F', // 🎖️ official
|
||||||
|
'\u{1F40D}', // 🐍 Python
|
||||||
|
'\u{1F4C7}', // 📇 TypeScript/JS
|
||||||
|
'\u{1F3CE}\uFE0F', // 🏎️ Go
|
||||||
|
'\u{1F980}', // 🦀 Rust
|
||||||
|
'#\uFE0F\u20E3', // #️⃣ C#
|
||||||
|
'\u2615', // ☕ Java
|
||||||
|
'\u{1F30A}', // 🌊 C/C++
|
||||||
|
'\u{1F48E}', // 💎 Ruby
|
||||||
|
'\u2601\uFE0F', // ☁️ Cloud
|
||||||
|
'\u{1F3E0}', // 🏠 Local
|
||||||
|
'\u{1F4DF}', // 📟 Embedded
|
||||||
|
'\u{1F34E}', // 🍎 macOS
|
||||||
|
'\u{1FAA9}', // 🪟 Windows
|
||||||
|
'\u{1F427}', // 🐧 Linux
|
||||||
|
];
|
||||||
|
|
||||||
|
// Only check added lines (starting with +) for glama link
|
||||||
|
const hasGlama = files.some(file =>
|
||||||
|
file.patch && file.patch.split('\n')
|
||||||
|
.filter(line => line.startsWith('+'))
|
||||||
|
.some(line => line.includes('glama.ai/mcp/servers'))
|
||||||
|
);
|
||||||
|
|
||||||
|
// Check added lines for emoji usage
|
||||||
|
const addedLines = files
|
||||||
|
.filter(f => f.patch)
|
||||||
|
.flatMap(f => f.patch.split('\n').filter(line => line.startsWith('+')))
|
||||||
|
.filter(line => line.includes('](https://github.com/'));
|
||||||
|
|
||||||
|
let hasValidEmoji = false;
|
||||||
|
let hasInvalidEmoji = false;
|
||||||
|
const invalidLines = [];
|
||||||
|
const badNameLines = [];
|
||||||
|
const duplicateUrls = [];
|
||||||
|
const nonGithubUrls = [];
|
||||||
|
|
||||||
|
// Check for non-GitHub URLs in added entry lines (list items with markdown links)
|
||||||
|
const allAddedEntryLines = files
|
||||||
|
.filter(f => f.patch)
|
||||||
|
.flatMap(f => f.patch.split('\n').filter(line => line.startsWith('+')))
|
||||||
|
.map(line => line.replace(/^\+/, ''))
|
||||||
|
.filter(line => /^\s*-\s*\[/.test(line));
|
||||||
|
|
||||||
|
for (const line of allAddedEntryLines) {
|
||||||
|
// Extract the primary link URL (first markdown link)
|
||||||
|
const linkMatch = line.match(/\]\((https?:\/\/[^)]+)\)/);
|
||||||
|
if (linkMatch) {
|
||||||
|
const url = linkMatch[1];
|
||||||
|
if (!url.startsWith('https://github.com/')) {
|
||||||
|
nonGithubUrls.push(url);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Check for duplicates
|
||||||
|
for (const line of addedLines) {
|
||||||
|
const ghMatch = line.match(/\(https:\/\/github\.com\/[^)]+\)/i);
|
||||||
|
if (ghMatch && existingUrls.has(ghMatch[0].toLowerCase())) {
|
||||||
|
duplicateUrls.push(ghMatch[0].replace(/[()]/g, ''));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
for (const line of addedLines) {
|
||||||
|
const usedPermitted = permittedEmojis.filter(e => line.includes(e));
|
||||||
|
if (usedPermitted.length > 0) {
|
||||||
|
hasValidEmoji = true;
|
||||||
|
} else {
|
||||||
|
// Line with a GitHub link but no permitted emoji
|
||||||
|
invalidLines.push(line.replace(/^\+/, '').trim());
|
||||||
|
}
|
||||||
|
|
||||||
|
// Check for emojis that aren't in the permitted list
|
||||||
|
const emojiRegex = /\p{Emoji_Presentation}|\p{Emoji}\uFE0F/gu;
|
||||||
|
const allEmojis = line.match(emojiRegex) || [];
|
||||||
|
const unknownEmojis = allEmojis.filter(e => !permittedEmojis.some(p => p.includes(e) || e.includes(p)));
|
||||||
|
if (unknownEmojis.length > 0) {
|
||||||
|
hasInvalidEmoji = true;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Check that the link text uses full owner/repo format
|
||||||
|
// Pattern: [link-text](https://github.com/owner/repo)
|
||||||
|
const entryRegex = /\[([^\]]+)\]\(https:\/\/github\.com\/([^/]+)\/([^/)]+)\)/;
|
||||||
|
const match = line.match(entryRegex);
|
||||||
|
if (match) {
|
||||||
|
const linkText = match[1];
|
||||||
|
const expectedName = `${match[2]}/${match[3]}`;
|
||||||
|
// Link text should contain owner/repo (case-insensitive)
|
||||||
|
if (!linkText.toLowerCase().includes('/')) {
|
||||||
|
badNameLines.push({ linkText, expectedName });
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const emojiOk = addedLines.length === 0 || (hasValidEmoji && !hasInvalidEmoji && invalidLines.length === 0);
|
||||||
|
const nameOk = badNameLines.length === 0;
|
||||||
|
const noDuplicates = duplicateUrls.length === 0;
|
||||||
|
const allGithub = nonGithubUrls.length === 0;
|
||||||
|
|
||||||
|
// Apply glama labels
|
||||||
|
const glamaLabel = hasGlama ? 'has-glama' : 'missing-glama';
|
||||||
|
const glamaLabelRemove = hasGlama ? 'missing-glama' : 'has-glama';
|
||||||
|
|
||||||
|
// Apply emoji labels
|
||||||
|
const emojiLabel = emojiOk ? 'has-emoji' : 'missing-emoji';
|
||||||
|
const emojiLabelRemove = emojiOk ? 'missing-emoji' : 'has-emoji';
|
||||||
|
|
||||||
|
// Apply name labels
|
||||||
|
const nameLabel = nameOk ? 'valid-name' : 'invalid-name';
|
||||||
|
const nameLabelRemove = nameOk ? 'invalid-name' : 'valid-name';
|
||||||
|
|
||||||
|
const labelsToAdd = [glamaLabel, emojiLabel, nameLabel];
|
||||||
|
const labelsToRemove = [glamaLabelRemove, emojiLabelRemove, nameLabelRemove];
|
||||||
|
|
||||||
|
if (!noDuplicates) {
|
||||||
|
labelsToAdd.push('duplicate');
|
||||||
|
} else {
|
||||||
|
labelsToRemove.push('duplicate');
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!allGithub) {
|
||||||
|
labelsToAdd.push('non-github-url');
|
||||||
|
} else {
|
||||||
|
labelsToRemove.push('non-github-url');
|
||||||
|
}
|
||||||
|
|
||||||
|
await github.rest.issues.addLabels({
|
||||||
|
owner,
|
||||||
|
repo,
|
||||||
|
issue_number: pr_number,
|
||||||
|
labels: labelsToAdd,
|
||||||
|
});
|
||||||
|
|
||||||
|
for (const label of labelsToRemove) {
|
||||||
|
try {
|
||||||
|
await github.rest.issues.removeLabel({
|
||||||
|
owner,
|
||||||
|
repo,
|
||||||
|
issue_number: pr_number,
|
||||||
|
name: label,
|
||||||
|
});
|
||||||
|
} catch (e) {
|
||||||
|
// Label wasn't present, ignore
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Post comments for issues, avoiding duplicates
|
||||||
|
const { data: comments } = await github.rest.issues.listComments({
|
||||||
|
owner,
|
||||||
|
repo,
|
||||||
|
issue_number: pr_number,
|
||||||
|
per_page: 100,
|
||||||
|
});
|
||||||
|
|
||||||
|
// Glama comment
|
||||||
|
if (!hasGlama) {
|
||||||
|
const marker = '<!-- glama-check -->';
|
||||||
|
if (!comments.some(c => c.body.includes(marker))) {
|
||||||
|
await github.rest.issues.createComment({
|
||||||
|
owner,
|
||||||
|
repo,
|
||||||
|
issue_number: pr_number,
|
||||||
|
body: `${marker}\nHey,
|
||||||
|
|
||||||
|
To ensure that only working servers are listed, we're updating our listing requirements.
|
||||||
|
|
||||||
|
Please complete the following steps:
|
||||||
|
|
||||||
|
1. **Ensure your server is listed on Glama.** If it isn't already, submit it at https://glama.ai/mcp/servers and verify that it passes all checks (including a successfully built Docker image and a release).
|
||||||
|
|
||||||
|
2. **Update your PR** by adding a \`[glama](https://glama.ai/mcp/servers/...)\` link immediately after the GitHub repository link, pointing to your server's Glama listing page.
|
||||||
|
|
||||||
|
If you need any assistance, feel free to ask questions here or on [Discord](https://glama.ai/discord).
|
||||||
|
|
||||||
|
P.S. If your server already has a hosted endpoint, you can also list it under https://glama.ai/mcp/connectors.`
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Emoji comment
|
||||||
|
if (!emojiOk && addedLines.length > 0) {
|
||||||
|
const marker = '<!-- emoji-check -->';
|
||||||
|
if (!comments.some(c => c.body.includes(marker))) {
|
||||||
|
const emojiList = [
|
||||||
|
'🎖️ – official implementation',
|
||||||
|
'🐍 – Python',
|
||||||
|
'📇 – TypeScript / JavaScript',
|
||||||
|
'🏎️ – Go',
|
||||||
|
'🦀 – Rust',
|
||||||
|
'#️⃣ – C#',
|
||||||
|
'☕ – Java',
|
||||||
|
'🌊 – C/C++',
|
||||||
|
'💎 – Ruby',
|
||||||
|
'☁️ – Cloud Service',
|
||||||
|
'🏠 – Local Service',
|
||||||
|
'📟 – Embedded Systems',
|
||||||
|
'🍎 – macOS',
|
||||||
|
'🪟 – Windows',
|
||||||
|
'🐧 – Linux',
|
||||||
|
].map(e => `- ${e}`).join('\n');
|
||||||
|
|
||||||
|
await github.rest.issues.createComment({
|
||||||
|
owner,
|
||||||
|
repo,
|
||||||
|
issue_number: pr_number,
|
||||||
|
body: `${marker}\nYour submission is missing a required emoji tag or uses an unrecognized one. Each entry must include at least one of the permitted emojis after the repository link.
|
||||||
|
|
||||||
|
**Permitted emojis:**
|
||||||
|
${emojiList}
|
||||||
|
|
||||||
|
Please update your PR to include the appropriate emoji(s). See existing entries for examples.`
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Duplicate comment
|
||||||
|
if (!noDuplicates) {
|
||||||
|
const marker = '<!-- duplicate-check -->';
|
||||||
|
if (!comments.some(c => c.body.includes(marker))) {
|
||||||
|
const dupes = duplicateUrls.map(u => `- ${u}`).join('\n');
|
||||||
|
await github.rest.issues.createComment({
|
||||||
|
owner,
|
||||||
|
repo,
|
||||||
|
issue_number: pr_number,
|
||||||
|
body: `${marker}\nThe following server(s) are already listed in the repository:
|
||||||
|
|
||||||
|
${dupes}
|
||||||
|
|
||||||
|
Please remove the duplicate entries from your PR.`
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Non-GitHub URL comment
|
||||||
|
if (!allGithub) {
|
||||||
|
const marker = '<!-- url-check -->';
|
||||||
|
if (!comments.some(c => c.body.includes(marker))) {
|
||||||
|
const urls = nonGithubUrls.map(u => `- ${u}`).join('\n');
|
||||||
|
await github.rest.issues.createComment({
|
||||||
|
owner,
|
||||||
|
repo,
|
||||||
|
issue_number: pr_number,
|
||||||
|
body: `${marker}\nWe only accept servers hosted on GitHub. The following URLs are not GitHub links:
|
||||||
|
|
||||||
|
${urls}
|
||||||
|
|
||||||
|
Please update your PR to use a \`https://github.com/...\` repository link.`
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Name format comment
|
||||||
|
if (!nameOk) {
|
||||||
|
const marker = '<!-- name-check -->';
|
||||||
|
if (!comments.some(c => c.body.includes(marker))) {
|
||||||
|
const examples = badNameLines.map(
|
||||||
|
b => `- \`${b.linkText}\` should be \`${b.expectedName}\``
|
||||||
|
).join('\n');
|
||||||
|
|
||||||
|
await github.rest.issues.createComment({
|
||||||
|
owner,
|
||||||
|
repo,
|
||||||
|
issue_number: pr_number,
|
||||||
|
body: `${marker}\nThe entry name must use the full \`owner/repo\` format (not just the repo name).
|
||||||
|
|
||||||
|
${examples}
|
||||||
|
|
||||||
|
For example: \`[user/mcp-server-example](https://github.com/user/mcp-server-example)\`
|
||||||
|
|
||||||
|
Please update your PR to use the full repository name.`
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user