CTFtime MCP Server

CTFtime MCP服务器

一种模型上下文协议（MCP）服务器，提供对 CTFtime.org 数据。通过标准化界面检索有关CTF比赛、球队排名、赛事详情和比赛结果的信息。

特性

工具

提示

资源

安装

先决条件

• Python 3.13或更高版本
• 紫外线 （推荐）或pip

使用紫外线（推荐）

git clone https://github.com/0x-Professor/CTF-time-mcp.git
cd ctf-times-mcp
uv sync

使用pip

git clone https://github.com/yourusername/ctf-times-mcp.git
cd ctf-times-mcp
pip install -e .

用法

运行服务器

# Using uv
uv run server.py

# Using Python directly
python server.py

开发模式

# Launch with MCP Inspector for testing
uv run mcp dev server.py

客户端配置

要将CTFtime MCP服务器添加到Claude Desktop，请运行以下命令：

uv run mcp install server.py --name "CTFtime"

克劳德桌面版

将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "ctftime": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ctf-times-mcp", "server.py"]
    }
  }
}

VS代码并继续

添加到“继续”配置中：

{
  "mcpServers": [
    {
      "name": "ctftime",
      "command": "uv",
      "args": ["run", "server.py"],
      "cwd": "/path/to/ctf-times-mcp"
    }
  ]
}

查询示例

连接到MCP兼容客户端后：

• “列出未来两周即将举行的CTF比赛”
• “获取CTF事件ID 2345的详细信息”
• “展示全球排名前20的CTF团队”
• “查找来自德国的CTF团队”
• “搜索与DEF CON相关的CTF事件”
• “显示2026年3月的CTF日历”

API 参考

此服务器与 CTFtime.org API.

使用的端点

速率限制

提供CTFtime.org API用于数据分析和应用程序开发。实施适当的请求限制以尊重服务器资源。

竞赛形式

挑战类别

项目结构

ctf-times-mcp/
├── server.py          # MCP server implementation
├── pyproject.toml     # Project configuration and dependencies
└── README.md          # Documentation

发展

测试

# Run with MCP Inspector
uv run mcp dev server.py

# Execute tests
uv run pytest

代码风格

本项目遵循PEP 8规范，并全程使用类型注释。

贡献

1. 分叉存储库
2. 创建要素分支(git checkout -b feature/enhancement)
3. 提交更改(git commit -m 'Add enhancement')
4. 推送到分支(git push origin feature/enhancement)
5. 打开拉取请求

许可证

该项目根据MIT许可证获得许可。看 许可证 了解详情。

致谢

• CTFtime.org -竞争跟踪平台和API
• 模型上下文协议 -协议规范
• MCP Python SDK -服务器实施框架

免责声明

这是一个独立的项目，不隶属于CTFtime.org或由其认可。请查看并遵守CTFtime.com的服务条款和API使用指南。