Ddnet Mcpserver

一个基于FastMCP的Model Context Protocol服务器，提供DDNet游戏进程管理和配置文件操作功能。

功能

• 游戏进程管理：获取DDNet游戏状态、启动和关闭DDNet游戏
• 配置文件操作：检查按键绑定、添加和删除按键绑定

安装

使用uv安装

uv install ddnet-mcpserver

使用方法

使用uv运行

uv run -m ddnet_mcpserver

在MCP客户端中配置

在您的MCP客户端配置文件中添加以下配置:

{
  "mcpServers": {
    "ddnet": {
      "command": "uvx",
      "args": ["ddnet-mcpserver"],
      "env": {},
      "disabled": false
    }
  }
}

可用工具

• get_ddnet_game_status(): 获取DDNet进程状态
• stop_ddnet_game(): 关闭DDNet进程
• start_ddnet_game(): 启动DDNet进程
• check_bind(bindkey: str): 检查按键是否被占用
• add_bind(bindkey: str, bindvalue: str): 增加按键绑定
• delete_bind(bindkey: str): 删除按键绑定

开发

设置开发环境

git clone https://github.com/silverhi/ddnet-mcpserver.git
cd ddnet-mcpserver
uv pip install -e .

本地开发指南

使用uv运行服务器

uv run -m ddnet_mcpserver

使用MCP Inspector调试

npx -y @modelcontextprotocol/inspector uv run -m ddnet_mcpserver

安装Node.js（Windows环境）

winget install jasongin.nvs
nvs add lts
nvs use lts

使用pre-commit进行代码检查

uv pip install pre-commit
pre-commit install

构建和发布包

python -m build
twine upload dist/*

许可证

MIT