DDNet MCP Server
一个基于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
1 maintainer
Metadata
1 maintainer
Release files for ddnet-mcpserver 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| ddnet_mcpserver-0.1.2.tar.gz | 24.2 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ddnet_mcpserver-0.1.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 30.6 kB
Release files / ddnet_mcpserver-0.1.2.tar.gz
| Download URL | ddnet_mcpserver-0.1.2.tar.gz |
|---|---|
| Size | 24.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ed51003a645214c73dfaeefb841cf6517112e7c68ae0a7a377d735cf1cfe1b71
|
|
BLAKE2b-256 checksum How to use checksums |
4b58211d7c24bc22838b8b1ae3e1347a1e4ce21f37ee66e56b102839e5a2f3d4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 26, 2025.
Transparency logRelease files / ddnet_mcpserver-0.1.2-py3-none-any.whl
| Download URL | ddnet_mcpserver-0.1.2-py3-none-any.whl |
|---|---|
| Size | 6.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c0447fe473162e498bb7154488548219474c6e71c41d20417eca9b05df7fe786
|
|
BLAKE2b-256 checksum How to use checksums |
0cb0faafb75b2b9b966e416534f20fe390087123bea774c5b563bd17da178a09
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 26, 2025.
Transparency logSecurity for ddnet-mcpserver 0.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for ddnet_mcpserver-0.1.2.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 26, 2025.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
