使用说明

我的MCP服务器

MCP（模型上下文协议）服务器的自动安装和管理系统。用于跨不同应用程序和平台管理MCP服务器的集中存储库。

⚠️ 当前平台支持

✅ 完全支持：

Windows 10/11+克劳德代码
macOS+克劳德代码

❌ 尚未支持（计划中）：

Linux+克劳德代码
克劳德桌面（Windows/macOS）
Windsurf IDE
光标IDE
带有Cline扩展名的VS代码

🚀 特性

✅ 自动安装 -使用单个命令安装所有MCP服务器
🔑 API密钥管理 -所需API密钥的交互式设置
🌍 全局作用域 -所有项目中都有可用的服务器(--scope user)
📦 基于注册表 -来自的动态服务器列表 servers/registry.json
🔄 HTTP传输支持 -适用于NPX和基于HTTP的服务器
📋 易于管理 -轻松添加、删除和列出服务器

📦 可用服务器（共10台）

服务器	描述	API密钥	状态
GitHub 🐙	存储库管理和API集成	🔑 必填	✅ 工作
操纵者 🎭	浏览器自动化和网络抓取❌ 无	✅ 工作
顺序思维 🧠	人工智能推理和思维链❌ 无	✅ 工作
魔法 ✨	UI组件生成（21st.dev）	❌ 无	✅ 工作
桌面指挥官 💻	桌面自动化和系统控制	❌ 无	✅ 工作
背景7 📚	上下文感知文档	❌ 无	✅ 工作（HTTP）
云运行 ☁️	谷歌云运行管理	🔑 必填	✅ 工作
Supabase 🗄️	数据库和后端服务	🔑 必填	⚠️ 需要API密钥
拥抱脸 🤗	人工智能模型和数据集访问	🔑 可选	⚠️ 需要API密钥
RunPod 🏃	GPU云基础设施管理	🔑 必填	🔧 自定义安装

🛠️ 快速开始

先决条件

窗户：

Windows 10/11
已安装Claude Code CLI
PowerShell 5.1+或PowerShell核心

macOS：

macOS 10.15+
已安装Claude Code CLI
Bash shell
jq（安装方式： brew install jq)

安装

窗户：

# Clone repository
git clone https://github.com/BTankut/My-MCP-Servers.git
cd My-MCP-Servers

# Install all servers (recommended)
.\scripts\install-working.ps1 -All

# Verify installation
claude mcp list

macOS：

# Clone repository
git clone https://github.com/BTankut/My-MCP-Servers.git
cd My-MCP-Servers

# Install jq if not already installed
brew install jq

# Install all servers (recommended)
./scripts/install-macos.sh --all

# Verify installation
claude mcp list

📋 安装选项

选项1：安装所有服务器（推荐）

窗户：

.\scripts\install-working.ps1 -All

macOS：

./scripts/install-macos.sh --all

从注册表安装所有9台服务器
使用全局范围(--scope user)
适用于所有项目

选项2：安装特定服务器

窗户：

.\scripts\install-working.ps1 -Servers "github,puppeteer,magic"

macOS：

./scripts/install-macos.sh --servers=github,puppeteer,magic

选项3：交互式安装（高级）

窗户：

.\scripts\install-enhanced.ps1 -Interactive -SetupKeys

macOS：

./scripts/install-enhanced-macos.sh --interactive --setup-keys

选择特定服务器
交互式API密钥设置
分步指导

🔑 API密钥设置

某些服务器需要API密钥才能实现全部功能：

GitHub个人访问令牌

首选 GitHub设置→ 开发人员设置→ 个人访问令牌
生成新令牌（经典）
选择范围： repo, user, gist
设置环境变量：

窗户：

[Environment]::SetEnvironmentVariable("GITHUB_PERSONAL_ACCESS_TOKEN", "your_token_here", "User")

macOS：

# Add to ~/.bashrc or ~/.zshrc
echo 'export GITHUB_PERSONAL_ACCESS_TOKEN="your_token_here"' >> ~/.zshrc
source ~/.zshrc

主管API密钥

首选 Supabase仪表板
选择您的项目→ 设置→ API
复制项目URL和匿名密钥
设置环境变量：

窗户：

[Environment]::SetEnvironmentVariable("SUPABASE_URL", "https://your-project.supabase.co", "User")
[Environment]::SetEnvironmentVariable("SUPABASE_ANON_KEY", "your_anon_key_here", "User")

macOS：

# Add to ~/.bashrc or ~/.zshrc
echo 'export SUPABASE_URL="https://your-project.supabase.co"' >> ~/.zshrc
echo 'export SUPABASE_ANON_KEY="your_anon_key_here"' >> ~/.zshrc
source ~/.zshrc

拥抱脸API代币（可选）

首选拥抱面部设置→ 访问令牌
创建新令牌
设置环境变量：

窗户：

[Environment]::SetEnvironmentVariable("HUGGINGFACE_API_TOKEN", "your_token_here", "User")

macOS：

# Add to ~/.bashrc or ~/.zshrc  
echo 'export HUGGINGFACE_API_TOKEN="your_token_here"' >> ~/.zshrc
source ~/.zshrc

谷歌云（用于云运行）

在以下位置创建项目谷歌云控制台
创建服务帐户并下载JSON密钥
设置环境变量：

窗户：

[Environment]::SetEnvironmentVariable("GOOGLE_CLOUD_PROJECT", "your-project-id", "User")
[Environment]::SetEnvironmentVariable("GOOGLE_APPLICATION_CREDENTIALS", "path\to\key.json", "User")

macOS：

# Add to ~/.bashrc or ~/.zshrc
echo 'export GOOGLE_CLOUD_PROJECT="your-project-id"' >> ~/.zshrc
echo 'export GOOGLE_APPLICATION_CREDENTIALS="/path/to/key.json"' >> ~/.zshrc
source ~/.zshrc

RunPod API密钥

首选 RunPod控制台→ 用户设置
创建新的API密钥
设置环境变量：

窗户：

[Environment]::SetEnvironmentVariable("RUNPOD_API_KEY", "your_api_key_here", "User")

macOS：

# Add to ~/.bashrc or ~/.zshrc
echo 'export RUNPOD_API_KEY="your_api_key_here"' >> ~/.zshrc
source ~/.zshrc

🔧 自定义服务器设置（RunPod）

RunPod服务器需要手动安装，因为它无法通过NPX获得：

先决条件：

已安装Node.js 18+
Git已安装

安装：

# Clone RunPod MCP server (in any directory)
git clone https://github.com/runpod/runpod-mcp-ts.git
cd runpod-mcp-ts

# Install dependencies and build
npm install
npm run build

# Set API key (see API Key Setup above)
# Windows:
[Environment]::SetEnvironmentVariable("RUNPOD_API_KEY", "your_api_key_here", "User")

# macOS/Linux:
export RUNPOD_API_KEY="your_api_key_here"

使用脚本自动安装： 如果内置在公共位置，我们的安装程序脚本将自动检测RunPod：

./runpod-mcp-ts/ （与“我的MCP服务器”目录相同）
../runpod-mcp-ts/ （父目录）
~/runpod-mcp-ts/ （用户主目录）
C:\runpod-mcp-ts\ （Windows根用户）

使用增强的自定义安装程序：

窗户：

.\scripts\install-enhanced-custom.ps1 -Interactive -SetupKeys

macOS：

./scripts/install-enhanced-custom-macos.sh --interactive --setup-keys

安装程序将：

指导您完成API密钥设置
检查RunPod服务器是否在本地构建
自动创建包装脚本 对于环境变量
使用包装器将其安装到Claude Code

🔧 可用脚本

`install-working.ps1` （推荐）

目的：生产就绪安装程序
用法: .\scripts\install-working.ps1 -All
特性：基于注册表、HTTP支持、错误处理

`install-enhanced.ps1` （高级）

目的：具有API密钥管理功能的交互式安装程序
用法: .\scripts\install-enhanced.ps1 -Interactive -SetupKeys
特性：交互式模式，自动设置API密钥

`install-enhanced-custom.ps1` （自定义服务器）

目的：支持自定义/本地构建服务器，如RunPod
用法: .\scripts\install-enhanced-custom.ps1 -Interactive -SetupKeys
特性：自定义服务器检测，本地构建支持

`install-macos.sh` （macOS简单版）

目的：适用于macOS的生产就绪安装程序
用法: ./scripts/install-macos.sh --all
特性：基于注册表的错误处理

`install-enhanced-custom-macos.sh` （macOS自定义）

目的：支持自定义服务器的macOS安装程序
用法: ./scripts/install-enhanced-custom-macos.sh --interactive --setup-keys
特性：交互模式，自定义服务器检测

`install.ps1` （遗产）

目的：功能完整的安装程序
用法: .\scripts\install.ps1 -All -Apps "claude-code"
特性：多应用程序支持、备份、模拟运行模式

🔧 包装脚本实用程序

对于需要环境变量的自定义服务器（如RunPod），我们提供包装器脚本生成器：

`utils/create-wrapper.sh` （macOS/Linux）

./scripts/utils/create-wrapper.sh --server=runpod --path=/path/to/server.js --env-vars=RUNPOD_API_KEY

`utils/Create-Wrapper.ps1` （Windows）

.\scripts\utils\Create-Wrapper.ps1 -Server runpod -ServerPath "C:\path\to\server.js" -EnvVars "RUNPOD_API_KEY"

包装器脚本的作用是什么：

设置所需的环境变量
启动配置正确的MCP服务器
解决Claude Code的环境变量限制
使基于API密钥的服务器能够正常工作

📁 项目结构

My-MCP-Servers/
├── README.md                    # This file
├── scripts/
│   ├── install-working.ps1      # Main installer (Windows)
│   ├── install-enhanced.ps1     # Interactive installer (Windows)
│   ├── install-enhanced-custom.ps1 # Custom server installer (Windows)
│   ├── install-macos.sh         # Main installer (macOS)
│   ├── install-enhanced-macos.sh # Interactive installer (macOS)
│   ├── install-enhanced-custom-macos.sh # Custom server installer (macOS)
│   ├── install.ps1              # Legacy installer (Windows)
│   ├── install.sh               # Legacy installer (macOS/Linux)
│   └── utils/
│       ├── create-wrapper.sh    # Wrapper generator (macOS/Linux)
│       └── Create-Wrapper.ps1   # Wrapper generator (Windows)
├── servers/
│   └── registry.json            # Server definitions
└── configs/                     # Platform-specific configs (planned)
    ├── claude-desktop/
    ├── windsurf/
    └── cursor/

🔍 故障排除

MCP服务器不可见

# Restart Claude Code session
exit
claude

# Check server status
claude mcp list

API关键问题

# Check environment variables
[Environment]::GetEnvironmentVariable("GITHUB_PERSONAL_ACCESS_TOKEN", "User")

# Setup keys interactively
.\scripts\install-enhanced.ps1 -SetupKeys

连接问题

# Check server health
claude mcp list

# Reinstall problematic server
claude mcp remove server_name
.\scripts\install-working.ps1 -Servers "server_name"

🚧 路线图

平台支持

[x] macOS支持(install-macos.sh)
[]Linux支持(install-linux.sh)
[]克劳德桌面配置
[]Windsurf IDE集成
[]游标IDE集成
[]VS Code Cline扩展支持

特性

[]服务器更新机制
[]配置备份/还原
[]Web用户界面（可选）
[]团队共享功能
[]自定义服务器开发模板

🤝 贡献

分叉存储库
创建要素分支(git checkout -b feature/new-server)
进行更改
在Windows+Claude代码上进行彻底测试
提交拉取请求

添加新服务器

将服务器定义添加到 servers/registry.json
测试安装 .\scripts\install-working.ps1 -Servers "new-server"
更新README.md服务器表
提交PR

📄 许可证

这个项目是供个人使用的。各个MCP服务器都有自己的许可证。

🆘 支持

问题: GitHub问题
讨论：使用GitHub讨论提问
文档：查看此README和脚本注释

⚠️ 重要：目前支持Windows+克劳德代码和macOS+克劳德代码。其他平台正在计划中，但尚未实施。

💡 小贴士：使用 -All 标记首次安装以安装所有可用服务器！

使用说明

我的MCP服务器

⚠️ 当前平台支持

🚀 特性

📦 可用服务器（共10台）

🛠️ 快速开始

先决条件

安装

📋 安装选项

选项1：安装所有服务器（推荐）

选项2：安装特定服务器

选项3：交互式安装（高级）

🔑 API密钥设置

GitHub个人访问令牌

主管API密钥

拥抱脸API代币（可选）

谷歌云（用于云运行）

RunPod API密钥

🔧 自定义服务器设置（RunPod）

🔧 可用脚本

install-working.ps1 （推荐）

install-enhanced.ps1 （高级）

install-enhanced-custom.ps1 （自定义服务器）

install-macos.sh （macOS简单版）

install-enhanced-custom-macos.sh （macOS自定义）

install.ps1 （遗产）

🔧 包装脚本实用程序

utils/create-wrapper.sh （macOS/Linux）

utils/Create-Wrapper.ps1 （Windows）

📁 项目结构

🔍 故障排除

MCP服务器不可见

API关键问题

连接问题

🚧 路线图

平台支持

特性

🤝 贡献

添加新服务器

📄 许可证

🆘 支持

相关 MCP

MCP服务器管理工具

APISIX MCP服务器

Shell命令执行服务

MCP服务器管理服务

模型上下文协议服务器

API测试管理工具

`install-working.ps1` （推荐）

`install-enhanced.ps1` （高级）

`install-enhanced-custom.ps1` （自定义服务器）

`install-macos.sh` （macOS简单版）

`install-enhanced-custom-macos.sh` （macOS自定义）

`install.ps1` （遗产）

`utils/create-wrapper.sh` （macOS/Linux）

`utils/Create-Wrapper.ps1` （Windows）