使用说明
竞赛日历MCP服务器-重构结构
项目结构
contest-calendar-mcp/
├── config.py # Configuration settings and constants
├── utils.py # Utility functions for time conversion
├── database.py # Database management and queries
├── fetchers.py # API fetchers for contest platforms
├── calendar_manager.py # Google Calendar integration
├── tools.py # MCP tool implementations
├── server.py # Main MCP server entry point
├── requirements.txt # Python dependencies
└── README.md # Documentation
~/.contest_calendar/ # Data directory (auto-created)
├── contests.db # SQLite database
├── token.pickle # Google OAuth token
└── credentials.json # Google OAuth credentials (user provided)
安装说明
1.安装依赖项
pip install fastmcp aiohttp google-auth-oauthlib google-api-python-client
或运行：
pip install -r requirements.txt
2.谷歌日历设置
- 首选 谷歌云控制台
- 创建新项目或选择现有项目
- 启用Google日历API
- 创建OAuth 2.0凭据（桌面应用程序）
- 下载凭据并另存为
~/.contest_calendar/credentials.json
3.运行服务器
python server.py
首次运行时，它将打开一个浏览器进行谷歌身份验证。
调试指南
测试单个组件
测试数据库：
from database import ContestDatabase
db = ContestDatabase()
contests = db.get_upcoming_contests()
print(contests)
测试取件器：
import asyncio
from fetchers import ContestFetcher
async def test():
contests = await ContestFetcher.fetch_codeforces()
print(contests)
asyncio.run(test())
测试日历：
from calendar_manager import GoogleCalendarManager
cal = GoogleCalendarManager()
cal.authenticate()
events = cal.list_events()
print(events)
测试工具：
from datetime import datetime, timezone
from utils import to_ist, format_ist_time
now = datetime.now(timezone.utc)
print(format_ist_time(now))
添加新平台
要添加新的竞赛平台（例如AtCoder）：
- 在
config.py：添加API URL常量 - 在
fetchers.py：添加fetch_atcoder()方法 - 在
fetchers.py：更新fetch_all()包括新的提取器
例子：
# In config.py
ATCODER_API_URL = "https://atcoder.jp/contests/..."
# In fetchers.py
@staticmethod
async def fetch_atcoder():
# Implementation here
pass
@staticmethod
async def fetch_all():
results = await asyncio.gather(
ContestFetcher.fetch_codeforces(),
ContestFetcher.fetch_leetcode(),
ContestFetcher.fetch_codechef(),
ContestFetcher.fetch_atcoder(), # Add here
return_exceptions=True
)
# Rest of the code...
在生产中运行
对于生产部署：
# Run with process manager
pm2 start server.py --interpreter python3 --name contest-calendar
