使用说明
MCP演示-Autonomy MCP服务器的沙盒
这是一个用于测试 自主MCP服务器 与GitHub、Vercel和Google Drive的集成。
概述
此演示包括:
- 测试GitHub存储库(
Bmathews721/mcp-demo) - Vercel项目用于部署测试
- 带有示例文档的Google Drive文件夹
- 用于测试MCP服务器的Next.js应用程序示例
快速开始
1.GitHub仓库
此存储库设置在: github.com/Bmathews721/mcp-demo
测试证书:
Repository: autonomy/mcp-demo
Clone URL: git@github.com:Bmathews/mcp-demo.git
Access: Public (for review purposes)
2.Vercel项目
项目详情:
Project Name: mcp-demo
Project ID: prj_YQbqYnzMJpX1QjXeRketjVfk3gfA
URL: mcp-demo-git-main-autonomy-ai.vercel.app
Environment: Preview/Development
部署:
# Install Vercel CLI
npm i -g vercel
# Deploy
cd sandbox/mcp-demo
vercel deploy
# Deploy to production
vercel --prod
3.谷歌驾驶测试数据
位于Google Drive文件夹中(ID: 1OEc4_A-gckgYt49Q6eOvhNDKo4FZYC-3):
sample-report.pdf-示例PDF文档metrics-dashboard.xlsx-Excel电子表格示例user-export.csv-CSV导出示例api-logs.txt-示例文本日志文件
看 docs/GOOGLE_DRIVE_SETUP.md 有关设置说明。
项目结构
mcp-demo/
├── README.md # This file
├── package.json # Node dependencies
├── vercel.json # Vercel configuration
├── .env.example # MCP credentials template
├── app/ # Next.js app directory
│ ├── page.tsx # Homepage
│ ├── layout.tsx # Root layout
│ └── api/ # API routes
│ ├── health/ # Health check endpoint
│ └── data/ # Demo data endpoints
└── docs/ # MCP Server documentation
├── API.md # Next.js API reference
├── CREDENTIALS.md # MCP credential setup guide
└── GOOGLE_DRIVE_SETUP.md # Google Drive setup guide
对于 MCP服务器 源代码和文档,请参阅:
mcp-autonomy/
├── src/ # MCP server source code
│ ├── index.ts # Server entry point
│ ├── github.ts # GitHub integration
│ ├── vercel.ts # Vercel integration
│ └── drive.ts # Google Drive integration
├── USER_GUIDE.md # End-user setup guide
├── DEVELOPER_GUIDE.md # Developer guide
├── API_REFERENCE.md # MCP tools documentation
├── ARCHITECTURE.md # System design
├── TROUBLESHOOTING.md # Common issues
├── SECURITY.md # Security best practices
└── ROADMAP.md # Future features
API终点
健康检查
GET https://mcp-demo-pi.vercel.app/api/health]
答复:
{
"status": "ok",
"service": "mcp-demo-sandbox",
"timestamp": "2025-10-28T10:00:00Z"
}
模拟数据端点
获取用户
GET https://mcp-demo-pi.vercel.app/api/data/users
获取项目
GET https://mcp-demo-pi.vercel.app/api/data/projects
获取指标
GET https://mcp-demo-pi.vercel.app/api/data/metrics
环境变量
复制 .env.example 到 .env.local 并配置MCP服务器凭据:
# Application
NEXT_PUBLIC_APP_NAME=MCP Demo
NEXT_PUBLIC_APP_URL=https://mcp-demo-pi.vercel.app/
# MCP Server Credentials (see docs/CREDENTIALS.md for setup)
GITHUB_TOKEN=ghp_your_github_token_here
VERCEL_API_TOKEN=your_vercel_token_here
GOOGLE_SERVICE_ACCOUNT_EMAIL=your-service-account@project.iam.gserviceaccount.com
GOOGLE_SERVICE_ACCOUNT_KEY_FILE=./path/to/service-account-key.json
GOOGLE_DRIVE_FOLDER_ID=1OEc4_A-gckgYt49Q6eOvhNDKo4FZYC-3
有关详细的凭据设置说明,请参阅 docs/CREDENTIALS.md.
测试MCP集成
1.GitHub集成
# Test repository access
gh repo view Bmathews/mcp-demo
# List files
gh api repos/Bmathews/mcp-demo/contents
2.Vercel集成
# Get project info
vercel project ls
# Get deployments
vercel list mcp-demo
3.谷歌云端硬盘集成
Folder: MCP Demo - Sandbox Data
URL: https://drive.google.com/drive/folders/1OEc4_A-gckgYt49Q6eOvhNDKo4FZYC-3
Contains:
- sample-document.pdf
- metrics-report.xlsx
- user-data-export.csv
- api-logs-sample.txt
审阅者证书
看 docs/CREDENTIALS.md 获取完整访问详细信息。
快速访问:
- GitHub:公共存储库,无需凭据
- Vercel:可通过URL访问预览部署
- 驱动器:具有仅查看权限的共享文件夹
安全说明
⚠️ 重要:这是一个沙盒/演示环境。
- 使用您自己的API证书(GitHub、Vercel、Google Drive)
- 所有MCP工具 只读的 -无写入操作
- 无生产数据或系统
- 可安全测试MCP集成
- 看 docs/CREDENTIALS.md 凭证安全最佳实践
支持
关于沙盒的问题:
- 打开一个问题:
github.com/Bmathews721/mcp-demo/issues - 联系人:sandbox-support@auai.cloud
许可证
MIT许可证-仅用于演示目的