Cyphers MCP服务器（Python）
Neople Cyphers Open API的模型上下文协议（MCP）服务器。
📋 介绍
该MCP服务器使Neople的Cyphers Open API易于在Claude、Cursor、Cline等AI助手中使用。提供玩家搜索、匹配记录查询、排名查询、物品搜索等多种功能。
主要功能
📚 Resources（游戏上下文）
MCP Server为LLM提供了关于尺寸游戏的上下文：
| Resource URI | 说明 |
|---|---|
cyphers://game-context | 游戏规则、系统、术语、元分析等 |
cyphers://characters | 角色列表、角色分类、评价指标等 |
帮助LLM在接收API数据时正确解释和分析API数据。
🔧 玩家工具
cy_players_search-使用昵称搜索玩家cy_players_get-查看玩家详细信息cy_players_matches-查看玩家匹配历史记录
匹配工具
cy_matches_get-查询匹配详细信息
排名工具
cy_ranking_ratingpoint-查看综合排名cy_ranking_characters-按角色查询排名cy_ranking_tsj-查看投身前排名
项目工具
cy_battleitems_search-搜索物品cy_battleitems_get-查看物品详细信息cy_battleitems_multi_get-一次查看多个物品（最多30个）
角色工具
cy_characters_list-查看所有角色列表
图像工具
cy_images_character_url-创建角色图像URLcy_images_item_url-创建项目图像URL
🚀 安装
基本要求
- Python 3.10或更高版本
- pip或uv
安装方法
# 저장소 클론
git clone https://github.com/DHKim327/CyphersMCPServer.git
cd CyphersMCPServer
# venv 환경 생성 및 활성화
python3 -m venv .venv
source .venv/bin/activate # Linux/macOS
# .venv\Scripts\activate # Windows
# 의존성 설치
pip install -e .安装开发依赖性
pip install -e ".[dev]"设置⚙ENT
1.发放API密钥
- 新手开发者订阅
- 注册应用程序
- Cyphers API密钥发放
2.设置环境变量
Linux/macOS：
export CYPHERS_API_KEY="your-api-key-here"窗户：
set CYPHERS_API_KEY=your-api-key-here3.运行服务器
# 직접 실행
python -m cyphers_mcp.server
# 또는 설치 후 명령어로 실행
cyphers-mcp🔧 MCP客户端设置
Cursor设置
添加到Cursor设置文件：
macOS/Linux： ~/.cursor/mcp.json 窗户： %APPDATA%\Cursor\mcp.json
{
"mcpServers": {
"cyphers": {
"command": "python",
"args": ["-m", "cyphers_mcp.server"],
"cwd": "/path/to/CyphersMCPServer",
"env": {
"CYPHERS_API_KEY": "your-api-key-here"
}
}
}
}Claude桌面设置
添加到Claude Desktop配置文件：
macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json Linux： ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"cyphers": {
"command": "python",
"args": ["-m", "cyphers_mcp.server"],
"cwd": "/home/kdhadsfasdf/CyphersMCPServer",
"env": {
"CYPHERS_API_KEY": "your-api-key-here"
}
}
}
}Cline（VS Code Extension）设置
- 在VS Code中安装Cline扩展
- 打开Cline设置
- 添加MCP服务器：
- 命令： python -m cyphers_mcp.server - 环境变量： CYPHERS_API_KEY=your-api-key-here
📖 使用示例
搜索玩家
닉네임 "플레이어이름"으로 사이퍼즈 플레이어를 검색해줘查询最近的战绩
플레이어 ID "xxx"의 최근 10경기를 조회하고 승률을 분석해줘查询排名
현재 레이팅 상위 10명의 랭킹을 보여줘🏗️ 项目结构
CyphersMCPServer/
├── cyphers_mcp/
│ ├── __init__.py # 패키지 초기화
│ ├── server.py # MCP 서버 메인
│ ├── api_client.py # Cyphers API 클라이언트
│ ├── types.py # 타입 정의
│ ├── cache.py # 캐싱 관리
│ └── rate_limiter.py # 레이트 리밋 관리
├── docs/ # 게임 컨텍스트 문서 (MCP Resources)
│ ├── cyphers_game_context.md # 게임 규칙, 용어, 메타
│ └── characters_reference.md # 캐릭터 목록, 역할 분류
├── note/ # 프로젝트 노트
├── pyproject.toml # Python 패키지 설정
├── README.md # 이 문서
└── smithery.json # Smithery 배포 설정🔧 高级功能
缓存
服务器自动缓存响应以优化API调用：
- 角色列表：24小时
- 物品详细信息：6小时
- 玩家信息：5分钟
- 排名：1分钟
- 比赛记录：30秒
限时
为了遵守Neople API的速率限制，自动限制请求：
- 每秒最多100次（保守设置）
- 每分钟最多5000件
- 每小时最多300000件
🐛 故障排除
API密钥错误
Error: CYPHERS_API_KEY environment variable is required→环境变量 CYPHERS_API_KEY请检查是否已设置。
依赖性错误
# 의존성 재설치
pip install -e . --force-reinstallMCP连接错误
- 检查Python版本（需要3.10或更高版本）
- 验证软件包安装是否正确
- 验证环境变量路径是否正确
📚 参考资料
📄 许可证
MIT许可证
👤 作者
DHKim327