GitHub Stars贡献管理MCP服务器

一个用于管理和跟踪GitHub Stars贡献的MCP服务器,支持通过自然语言与AI助手交互管理社区贡献。

  • by AnandChowdhary
  • JavaScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 AnandChowdhary/github-stars-contributions-mcp

使用说明

⭐ 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代币

  1. 首选 stars.github.com/profile
  2. 导航到 代币 标签
  3. 复制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.

服务器未连接

  1. 确保已安装Node.js v18+
  2. 检查一下 GITHUB_STARS_TOKEN 设置正确
  3. 配置更改后重新启动AI助手

🔗 相关项目

📃 许可证

ISC© 阿南德·乔杜里