使用说明
MCP服务器集合-生产就绪AI自动化平台
用于人工智能自动化的模型上下文协议（MCP）服务器的全面集合，专为企业使用而设计，并针对印度尼西亚市场进行了优化。建造于 CampShure 用于可扩展的业务自动化。
🌟 特性
完成MCP服务器收集
- 📅 日历服务器：用于日程安排自动化的Google日历集成
- 📁 文件系统服务器：通过工作区隔离实现安全的文件管理
- 🐙 GitHub服务器：存储库管理和自动化
- 📧 Gmail服务器：电子邮件自动化和管理
- 🔍 困惑服务器：人工智能驱动的搜索和知识检索
- 💬 Slack服务器：团队沟通自动化
- 🌤️ 天气服务器：国家气象局的天气数据和警报
生产就绪基础设施
- 🚀 完整的CI/CD管道：自动化测试、构建和部署
- 🐳 Docker容器化：可扩展的基于容器的架构
- 🔒 安全第一：用户隔离、速率限制、全面安全
- 📊 监控：健康检查、日志记录和性能指标
- 🌏 印尼市场准备就绪：时区、语言和业务优化
📋 先决条件
- Docker&Docker编写：容器运行时
- Python 3.11+：编程语言
- Git：版本控制
- Nginx （可选）：反向代理
- 有效的API密钥：用于外部服务（Gmail、Slack、GitHub、困惑）
🚀 快速开始
1.克隆存储库
git clone https://github.com/classifyingcompany/mcp-servers.git
cd mcp-servers
2.地方发展
# Create virtual environment
python -m venv venv
source venv/bin/activate # Linux/Mac
# venv\Scripts\activate # Windows
# Install dependencies
pip install -r requirements.txt
# Run status check
python check_status.py
# Start development server
python main.py
3.生产部署
# Run automated deployment script
./deploy.sh
# Configure environment
cp .env.example .env
nano .env # Edit with your configuration
# Start all services
sudo systemctl start mcp-servers
# Check status
docker-compose ps
🔧 配置
环境设置
# Essential Configuration (.env)
ENVIRONMENT=production
SECRET_KEY=your-super-secret-key
API_KEY=your-mcp-api-key
# Indonesian Market Settings
DEFAULT_TIMEZONE=Asia/Jakarta
DEFAULT_LANGUAGE=id
BABEL_LOCALE=id_ID
# API Keys
GMAIL_CLIENT_ID=your-gmail-client-id
GMAIL_CLIENT_SECRET=your-gmail-client-secret
SLACK_BOT_TOKEN=xoxb-your-slack-token
GITHUB_TOKEN=your-github-token
PERPLEXITY_API_KEY=your-perplexity-key
GitHub秘密（CI/CD）
自动部署所需的秘密：
PRODUCTION_HOST: your-server.com
PRODUCTION_USER: deploy-user
SSH_PRIVATE_KEY: |
-----BEGIN OPENSSH PRIVATE KEY-----
your-ssh-private-key-here
-----END OPENSSH PRIVATE KEY-----
SSH_PORT: 22
SLACK_WEBHOOK_URL: https://hooks.slack.com/services/...
🏗️ 建筑
graph TB
A[GitHub Repository] --> B[GitHub Actions CI/CD]
B --> C[Docker Build]
C --> D[Production Server]
D --> E[Docker Compose Stack]
E --> F[MCP Servers Container]
E --> G[Redis Cache]
E --> H[PostgreSQL Database]
E --> I[Nginx Reverse Proxy]
E --> J[Monitoring Stack]
F --> K[Calendar Server]
F --> L[Gmail Server]
F --> M[Slack Server]
F --> N[GitHub Server]
F --> O[Filesystem Server]
F --> P[Perplexity Server]
F --> Q[Weather Server]
🔄 CI/CD管道
自动化部署流程
- 代码推送：开发人员推送到主分支
- 测试：自动pytest、linting、安全扫描
- 建筑：Docker镜像创建与优化
- 部署：SSH部署到生产服务器
- 健康检查：验证所有服务是否正常
- 通知：部署状态通知延迟
手动部署
# Deploy via GitHub Actions
gh workflow run deploy.yml
# Or deploy locally
docker-compose up -d --build
# Check deployment status
./health_check.sh
📊 监控与管理
健康监测
# Overall health check
python check_status.py
# Service status
sudo systemctl status mcp-servers
# Container logs
docker-compose logs -f mcp-servers
# Individual server health
curl http://localhost:8000/health
性能监控
- Grafana仪表板:
http://your-server:3000 - 普罗米修斯指标:
http://your-server:9090 - 日志分析:
/opt/mcp-servers/logs/
备份和恢复
# Manual backup
/usr/local/bin/backup-mcp-servers
# Automated daily backups (configured via cron)
# View backup status
ls -la /var/backups/mcp-servers/
🧪 测试
运行测试套件
# All tests
python -m pytest tests/ -v
# Specific server tests
python -m pytest tests/test_all_servers.py::TestWeatherServer -v
# Coverage report
python -m pytest tests/ --cov=. --cov-report=html
印尼市场测试
# Test Indonesian-specific features
python -m pytest tests/test_all_servers.py::TestIndonesianMarketFeatures -v
🔌 API使用示例
天气服务器
# Get Indonesian weather alerts
await get_alerts("ID") # Indonesia weather alerts
# Jakarta weather forecast
await get_forecast(-6.2088, 106.8456) # Jakarta coordinates
日历服务器
# Create meeting in Jakarta timezone
await create_event(
title="Team Standup",
start_datetime="2024-01-15T09:00:00+07:00", # WIB timezone
end_datetime="2024-01-15T09:30:00+07:00"
)
困惑服务器
# Indonesian market research
await research_indonesian_market(
topic="fintech Indonesia 2024",
focus_areas=["regulations", "digital banking", "investment"]
)
# Competitor analysis
await analyze_competitors(
company_or_industry="ride-sharing Indonesia",
include_financials=True
)
🛠️ 发展
添加新服务器
- 创建服务器文件:
your_server.py - 遵循MCP模式:
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("your-server")
@mcp.tool()
async def your_function(param: str) -> str:
"""Your function description."""
return "result"
def main():
mcp.run(transport='stdio')
- 更新配置：添加到
main.py和check_status.py - 添加测试：在中创建测试
tests/ - 更新文档
印尼市场定制
- 时区：默认为
Asia/Jakarta - 语言：支持印尼语(
id)和英语(en) - 营业时间时间：09:00-17:00
- 当地节假日：印度尼西亚国家和宗教节日
- 货币：金融计算中的印尼盾支持
📁 项目结构
mcp-servers/
├── .github/
│ ├── workflows/ # CI/CD pipeline
│ ├── ISSUE_TEMPLATE/ # Issue templates
│ └── PULL_REQUEST_TEMPLATE.md
├── tests/ # Test suite
├── monitoring/ # Prometheus & Grafana configs
├── logs/ # Application logs
├── user-workspaces/ # User file isolation
├── ssl/ # SSL certificates
│
├── calendar_server.py # 📅 Google Calendar integration
├── filesystem_server.py # 📁 File management
├── github_server.py # 🐙 GitHub automation
├── gmail_server.py # 📧 Email automation
├── perplexity_server.py # 🔍 AI search
├── slack_server.py # 💬 Team communication
├── weather_server.py # 🌤️ Weather data
│
├── main.py # Main application entry
├── check_status.py # Health monitoring
├── requirements.txt # Dependencies
├── Dockerfile # Container definition
├── docker-compose.yml # Multi-service setup
├── nginx.conf # Reverse proxy
├── deploy.sh # Deployment script
├── .env.example # Environment template
└── README.md # This documentation
🤝 贡献
开发工作流程
- 分叉 存储库
- 创建 特征分支：
git checkout -b feature/amazing-feature - 跟随 印尼编码标准和文件
- 添加 新功能测试
- 提交 变化：
git commit -m 'Add amazing Indonesian feature' - 推 分支机构：
git push origin feature/amazing-feature - 打开 带详细描述的Pull Request
代码规范
- python：在有帮助的地方，用印尼评论关注PEP 8
- 文档：英语初级，印尼语示例
- 测试：需要全面的测试覆盖率
- 安全：企业使用的安全第一方法
🌏 印尼市场焦点
此MCP服务器集合专门针对印度尼西亚企业进行了优化：
- 🏢 企业就绪：与印尼公司进行了测试
- 🌐 就地安置：支持印尼银行、支付系统
- 📱 移动优化：印尼用户的移动优先策略
- 🔒 合规：符合印度尼西亚数据保护法规
- 💰 成本效益高：针对印尼云基础设施成本进行了优化
📝 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🆘 支持与社区
- 🐛 问题: GitHub问题
- 💬 讨论: GitHub讨论
- 📧 电子邮件: contact@campshure.com
- 🌐 网站: CampShure.com
🌟 致谢
内置于❤️ CampShure团队为印尼企业提供
印尼企业人工智能自动化民主化
