使用说明
⭐ GitHub明星贡献MCP
用于管理您的MCP(模型上下文协议)服务器 GitHub之星 贡献和个人资料-因此,像Claude Desktop和Cursor这样的人工智能助手可以帮助您通过自然语言跟踪您的社区贡献。
✨ 特性
稿件管理
- 添加贡献 --添加演讲、博客文章、视频和其他贡献
- 更新贡献 --修改现有贡献
- 删除贡献 --从您的个人资料中删除贡献
- 列出贡献 --通过分页检索您的所有贡献
个人资料链接
- 添加链接 --将社交/平台链接添加到您的个人资料中
- 删除链接 --删除个人资料链接
- 列出链接 --获取您的所有个人资料链接
查询工具
- 获取公开资料 --查看任何GitHub Star的公开个人资料
- 搜索星星 --浏览GitHub Stars目录
- 获取登录用户 --查看您自己的个人资料信息
📋 先决条件
- Node.js v18或更高版本
- GitHub Stars API代币 --从以下地址获取您的 stars.github.com/profile 在“令牌”选项卡下
🚀 快速启动
将服务器添加到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代币
- 首选 stars.github.com/profile
- 导航到 代币 标签
- 复制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令牌可能已过期。生成一个新的 stars.github.com/profile.
服务器未连接
- 确保已安装Node.js v18+
- 检查一下
GITHUB_STARS_TOKEN设置正确 - 配置更改后重新启动AI助手
🔗 相关项目
- github明星贡献CLI --Ahmad Awais的CLI工具
- GitHub之星计划 --GitHub Stars官方网站
📃 许可证
ISC© 阿南德·乔杜里
