⭐ GitHub明星贡献MCP
用于管理您的MCP(模型上下文协议)服务器 贡献和个人资料-因此,像Claude Desktop和Cursor这样的人工智能助手可以帮助您通过自然语言跟踪您的社区贡献。
✨ 特性
稿件管理
- 添加贡献 --添加演讲、博客文章、视频和其他贡献
- 更新贡献 --修改现有贡献
- 删除贡献 --从您的个人资料中删除贡献
- 列出贡献 --通过分页检索您的所有贡献
个人资料链接
- 添加链接 --将社交/平台链接添加到您的个人资料中
- 删除链接 --删除个人资料链接
- 列出链接 --获取您的所有个人资料链接
查询工具
- 获取公开资料 --查看任何GitHub Star的公开个人资料
- 搜索星星 --浏览GitHub Stars目录
- 获取登录用户 --查看您自己的个人资料信息
📋 先决条件
- Node.js v18或更高版本
- GitHub Stars API代币 --从以下地址获取您的 在“令牌”选项卡下
🚀 快速启动
将服务器添加到MCP配置中:
光标IDE
添加到您的 ~/.cursor/mcp.json:
{
"mcpServers": {
"github-stars": {
"command": "npx",
"args": ["-y", "github-stars-contributions-mcp"],
"env": {
"GITHUB_STARS_TOKEN": "your-api-token-here"
}
}
}
}克劳德桌面版
添加到您的Claude Desktop配置文件中:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"github-stars": {
"command": "npx",
"args": ["-y", "github-stars-contributions-mcp"],
"env": {
"GITHUB_STARS_TOKEN": "your-api-token-here"
}
}
}
}获取您的API代币
- 首选
- 导航到 代币 标签
- 复制API令牌并替换
your-api-token-here在上面的配置中
⚙️ 替代安装
来源
如果您更喜欢从源代码运行:
git clone https://github.com/AnandChowdhary/github-stars-contributions-mcp.git
cd github-stars-contributions-mcp
npm install然后使用此配置:
{
"mcpServers": {
"github-stars": {
"command": "node",
"args": [
"/absolute/path/to/github-stars-contributions-mcp/github-stars-contributions-mcp.mjs"
],
"env": {
"GITHUB_STARS_TOKEN": "your-api-token-here"
}
}
}
}独立运行
export GITHUB_STARS_TOKEN="your-api-token-here"
npx github-stars-contributions-mcp🎯 可用工具
add_contribution
在您的GitHub Stars个人资料中添加新的贡献。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
type | 枚举 | ✅ | SPEAKING, BLOGPOST, ARTICLE_PUBLICATION, EVENT_ORGANIZATION, HACKATHON, OPEN_SOURCE_PROJECT, VIDEO_PODCAST, FORUM, OTHER |
title | string | ✅ | 贡献的标题 |
description | string | ✅ | 捐款说明 |
date | string | ✅ | 在……约会 YYYY-MM-DD 或ISO格式 |
url | string | ❌ | 与贡献相关的URL |
update_contribution
更新现有贡献。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | string | ✅ | 要更新的贡献ID |
type | 枚举 | ❌ | 贡献类型 |
title | string | ❌ | 标题 |
description | string | ❌ | 说明 |
date | string | ❌ | 日期 |
url | string | ❌ | URL |
remove_contribution
从您的个人资料中删除贡献。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | string | ✅ | 要删除的贡献的ID |
list_contributions
得到你所有的贡献。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
first | 编号 | ❌ | 要提取的项目数 |
offset | 编号 | ❌ | 分页偏移 |
add_link
添加配置文件链接。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
link | string | ✅ | 链接的URL |
platform | 枚举 | ✅ | TWITTER, MEDIUM, LINKEDIN, README, STACK_OVERFLOW, DEV_TO, MASTODON, OTHER |
remove_link
删除配置文件链接。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | string | ✅ | 要删除的链接的ID |
list_links
获取您的所有个人资料链接。无需参数。
get_public_profile
获取GitHub Star的公开个人资料。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
username | string | ✅ | GitHub用户名 |
search_stars
搜索GitHub之星。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
featured | boolean | ❌ | 仅筛选到特色明星 |
get_logged_user
获取您自己的个人资料信息。无需参数。
📝 示例用法
一旦配置了AI助手,您就可以使用自然语言:
- _“添加我在GitHub Universe的演讲作为演讲贡献”_
- _“列出我今年的所有贡献”_
- _“添加我的推特个人资料链接”_
- _“给我看看章鱼的公开资料”_
- _“删除ID为abc123的贡献”_
📊 贡献类型
| 类型 | 描述 |
|---|---|
SPEAKING | 会议讲座、聚会、网络研讨会 |
BLOGPOST | 博客文章和教程 |
ARTICLE_PUBLICATION | 在杂志/期刊上发表的文章 |
EVENT_ORGANIZATION | 组织活动、聚会、会议 |
HACKATHON | 黑客马拉松参与或指导 |
OPEN_SOURCE_PROJECT | 开源贡献 |
VIDEO_PODCAST | YouTube视频、播客 |
FORUM | 论坛贡献、问答 |
OTHER | 任何其他出资类型 |
🔗 平台类型
| 类型 | 描述 |
|---|---|
TWITTER | 推特/X个人资料 |
MEDIUM | 媒体博客 |
LINKEDIN | LinkedIn个人资料 |
README | README配置文件 |
STACK_OVERFLOW | 堆栈溢出配置文件 |
DEV_TO | DEV社区简介 |
MASTODON | Mastodon个人资料 |
OTHER | 任何其他平台 |
🔧 故障排除
“GITHUB_STARS_TOKEN环境变量是必需的”
确保您已设置 GITHUB_STARS_TOKEN 在MCP配置中,或者将其导出到shell中。
“未经授权”的错误
您的API令牌可能已过期。生成一个新的 .
服务器未连接
- 确保已安装Node.js v18+
- 检查一下
GITHUB_STARS_TOKEN设置正确 - 配置更改后重新启动AI助手
🔗 相关项目
- --Ahmad Awais的CLI工具
- --GitHub Stars官方网站
📃 许可证
ISC© 阿南德·乔杜里
