AI导哈

Codex MCP 服务器管理 CLI

mcps 是一款用于管理 Codex 配置中 MCP 服务器的 Rust 命令行工具，支持启用、禁用、删除和列出 MCP 服务器，适用于需要高效维护 AI 编码助手服务连接的开发场景。

  • by tsarbas
  • Rust
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 tsarbas/mcps

使用说明

mcps

Small Rust CLI to enable, disable, remove, and list Codex MCP servers in your Codex config.

What it does

mcps edits MCP server entries under [mcp_servers.<name>] in a TOML config file.

  • Default config path: ~/.codex/config.toml
  • Override config path: --config /path/to/config.toml

Features

  • Enable a configured MCP server
  • Disable a configured MCP server
  • Remove a configured MCP server
  • List all configured MCP servers with status
  • Writes updates safely via temp file + replace

Requirements

  • Rust toolchain (cargo)
  • A valid Codex config containing [mcp_servers]

Installation

Option 1: Build + install script

./build.sh

This script:

  • Builds release binary (cargo build --release)
  • Installs mcps to ~/.local/bin by default
  • Prints whether your PATH already includes the install directory

Set a custom install directory:

MCPS_INSTALL_DIR="$HOME/bin" ./build.sh

Option 2: Cargo install from local path

cargo install --path .

Usage

mcps list
mcps enable <name>
mcps disable <name>
mcps enable '*github*'
mcps disable 'cloud*'
mcps disable '*'
mcps remove <name>
mcps --config /path/to/config.toml list

Run help:

mcps --help

For enable and disable, * matches zero or more characters anywhere in a server name. Matching is case-sensitive and covers the entire name; all other characters are literal. Quote patterns to prevent your shell from expanding them. Each command accepts one name or pattern and prints matched servers alphabetically, including servers already in the requested state. remove accepts exact names only. If no servers match, or any matched entry is invalid, the config is left unchanged.

Config expectations

Example config:

[mcp_servers.xcode]
command = "xcrun"
args = ["mcpbridge"]
enabled = true

Notes:

  • If enabled is missing for a server, list treats it as enabled.
  • enable/disable requires the server to already exist in [mcp_servers].
  • remove deletes the entire [mcp_servers.<name>] section. delete is an alias.

Output examples

mcps list:

Name   Status
xcode  enabled

mcps disable xcode:

xcode disabled

mcps enable xcode:

xcode enabled

mcps remove xcode:

xcode removed

Error cases

You can get errors when:

  • [mcp_servers] section is missing
  • Requested server name is not found
  • enabled exists but is not boolean
  • Config file cannot be read, parsed, or replaced

Development

Build:

cargo build

Run tests:

cargo test

Install release build:

./build.sh

Troubleshooting

  • mcps: command not found: add install directory (for example ~/.local/bin) to PATH.
  • Permission errors writing config: verify file ownership and directory permissions.
  • TOML parse errors: validate your config syntax and table structure.

License

No license file is currently included in this repository.

相关 MCP