AI导哈

GitHub组件访问服务

GTM Labs MCP Server 提供直接从GitHub获取组件的服务，支持通过自然语言访问最新组件、获取完整蓝图及设计规范，适用于快速组件复用和项目搭建。

  • by GTM-LABS-io
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 GTM-LABS-io/mcp-server

使用说明

GTM Labs MCP 服务器

直接从GitHub访问GTM Labs组件——始终保持最新！

通过AI助手即时访问GTM Labs组件。无需git克隆 - 组件直接从GitHub的API获取，因此您总是能获得最新版本。

🎯 这个的作用

GTM Labs MCP 服务器直接从 GitHub 获取组件，使您能够：

✅ 访问任何组件 通过自然语言即时完成
✅ 始终获取最新版本 - 无需执行 git pull！
✅ 获取完整蓝图 包含代码和依赖项
✅ 搜索组件 在所有项目中
✅（勾选标记，表示正确、完成或确认） 提取设计规格 （颜色、动画等）
✅ 没有本地存储 - 按需获取的组件

🚀 快速安装

一键安装

curl -fsSL https://raw.githubusercontent.com/GTM-LABS-io/mcp-server/main/install.sh | bash

搞定！无需使用git clone。组件将直接从GitHub获取。

安装了什么

  • MCP SDK（MCP软件开发工具包）
  • 请求库（用于GitHub API）
  • GTM Labs MCP服务器
  • IDE配置（Windsurf/Claude Desktop）

可选：GitHub 令牌

对于更高的速率限制（每小时5,000次请求，而非60次）：

  1. 在 https://github.com/settings/tokens 创建一个令牌
  2. 无需特殊权限
  3. 添加到 ~/.gtm-labs-mcp/config.json：
{
  "github_token": "your_token_here"
}

⚙️ 集成开发环境（IDE）配置

风帆冲浪

创造 .windsurf/mcp_config.json:

{
  "gtm-labs": {
    "command": "python3.11",
    "args": ["/Users/YOUR_USERNAME/.mcp-servers/gtm-labs/server.py"]
  }
}

重启风帆冲浪（或重新开始风帆冲浪活动）。

Claude Desktop（可译为“Claude桌面版”）

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "gtm-labs": {
      "command": "python3.11",
      "args": ["/Users/YOUR_USERNAME/.mcp-servers/gtm-labs/server.py"]
    }
  }
}

重启Claude桌面版。

其他兼容MCP的工具

使用以下方法遵循您的工具的MCP（多上下文处理）配置指南：

  • 命令： python3.11
  • 参数： ["/path/to/.mcp-servers/gtm-labs/server.py"]

🧪 测试

安装完成后，请在您的AI助手中尝试以下命令：

Use GTM Labs MCP to list all components
Use GTM Labs MCP to get the how-we-help-section component
Use GTM Labs MCP to show me the design tokens
Use GTM Labs MCP to search for animation components

预期：返回包含组件代码、规格和元数据的JSON响应。

📚 可用工具

1. list_components

列出所有组件，可选择按类别过滤。

示例：

List all section components using GTM Labs MCP

2. get_component

获取一个包含完整蓝图（代码、依赖项、规范）的组件。

示例：

Get the hero-section component with all dependencies

3. get_component_specs

获取详细规格（颜色、动画、边框、间距、字体）。

示例：

Show me the color specs for hero-section

4. search_components

按名称、内容或属性搜索组件。

示例：

Search for components with animation effects

5. get_changelog

获取组件或整个项目的版本历史。

示例：

Show changelog for hero-section

6. create_scaffold

创建一个包含选定组件的项目框架。

示例：

Create a Next.js scaffold with hero and navbar at ./new-project

🎨 有哪些可用选项

组件（50+）

  • 部分： 英雄、我们如何帮助、工作原理、内容库
  • UI（用户界面）: 按钮、卡片、输入框、横幅、工具提示
  • 动画： 自定义动画组件
  • 宇宙（Cosmic） 自定义设计系统（15+个组件）
  • MagicUI： 魔术效果库（8+个组件）
  • 实验： 便当式网格，实验性布局

配置

  • Tailwind 配置文件（270行，自定义动画）
  • 设计令牌（256行，完整设计系统）
  • Next.js 配置
  • 包含所有依赖项的 package.json

公用事业

  • 辅助函数
  • 设计系统令牌
  • 品牌常量（或品牌核心价值）

🔐 安全

MCP自动地：

  • 排除： .env*， *secrets*， *private*内部文档
  • 编辑： API密钥、CRM工具名称、凭证
  • 仅暴露： 面向公众的代码（组件、配置、实用工具）

📖 文档

🛠️ 配置

项目路径

MCP需要知道您的GTM Labs项目所在的位置。

配置文件： ~/.gtm-labs-mcp/config.json

{
  "project_root": "/Users/yourname/projects/gtm-homepage"
}

更新此路径，使其指向您的GTM Labs项目目录。

💡 使用场景

1. 快速组件重用

Get the how-we-help-section component with all dependencies

→ 立即访问组件代码、样式和依赖项

2. 创建新项目

Create a Next.js scaffold with hero, navbar, and footer at ./my-new-project

→ 完整的项目框架，包含您的组件

3. 提取特定样式

What colors does the cosmic-card component use?

→ 精确的 Tailwind 类名和颜色值

4. 版本控制

Get hero-section from version v1.0.0

→ 访问任何历史版本

🐛 故障排除

MCP 未加载

  1. 检查Python版本： python3.11 --version （必须为3.10及以上版本）
  2. 检查是否已安装MCP： pip3.11 show mcp
  3. 验证配置路径： cat ~/.gtm-labs-mcp/config.json
  4. 测试服务器： python3.11 ~/.mcp-servers/gtm-labs/server.py （按Ctrl+C停止）
  5. 完全重启您的集成开发环境（IDE）

组件未找到

  • 验证项目路径在 ~/.gtm-labs-mcp/config.json
  • 检查组件是否存在： ls /path/to/project/homepage/components/ui/
  • 使用精确的组件名称（短横线命名法）： hero-section，不是 HeroSection

Python版本错误

ERROR: Package 'mcp' requires a different Python: 3.9.6 not in '>=3.10'

解决方案： 安装 Python 3.11 或更高版本

brew install python@3.11  # macOS
sudo apt install python3.11  # Linux

🤝 贡献

我们欢迎投稿！请：

  1. 为仓库创建分支（或“克隆仓库”）
  2. 创建一个特性分支
  3. 做出你的更改
  4. 提交拉取请求

📄 许可证

MIT 许可证 - 请参阅 许可证 文件

🔗 链接

  • GitHub： https://github.com/gtm-labs/mcp-server 的中文翻译可以是：“https://github.com/gtm-labs/mcp-server（GitHub上的gym-labs组织的mcp-server项目）”。不过，通常在中文语境下，我们可能更倾向于直接使用网址本身，因为网址在中文中也是通用的，或者根据上下文简化为“GitHub上的mcp-server项目（由gtm-labs维护）”。如果需要更简洁的表达，也可以直接说“GitHub上的mcp-server（gtm-labs版）”
  • 文档： https://github.com/gtm-labs/mcp-server/wiki 翻译为中文是：https://github.com/gtm-labs/mcp-server/维基（或“文档页面”）
  • 问题： https://github.com/gtm-labs/mcp-server/issues 翻译为中文是：“https://github.com/gtm-labs/mcp-server 问题页面” 或者更简洁地表述为 “MCP服务器在GitHub上的问题追踪页面”
  • MCP协议： https://modelcontextprotocol.io 翻译为中文是：“https://模型上下文协议.io” 或者更简洁地表述为“模型上下文协议官网”。不过，通常网址在中文语境下直接保留原样，不进行翻译，除非是在特定的说明或介绍中需要解释其含义。因此，实际使用时，网址“https://modelcontextprotocol.io”通常保持不变

🎉 致谢

由GTM Labs为MCP社区打造。

由……提供支持/驱动

有问题吗？ 在GitHub上提交一个问题或查看 文档。

相关 MCP