Peter MCP Codex

彼得·麦克普法典

基础设施工具、MCP服务器和参考技能的统一monorepo。

快速概览

遵循Unix哲学的模块化工具集合：每个工具都能很好地完成一件事，并与其他工具协同工作。包括CLI工具、用于LLM集成的MCP服务器和参考技能。

结构

perf-mcp/                 # Linux performance troubleshooting MCP server (TypeScript)
cisco-mcp/                # Cisco NX-OS switch management (Python)
tool-sample/              # Template for creating new Python tools
mcp-base/                 # Shared Python MCP server base
genAI/skills/             # Reference skill documentation
setup.sh / reset.sh       # Tool installation and cleanup
mcp_config.toml           # MCP services configuration

先决条件

核心

• bash+通用Unix工具(awk, sed, grep)
• Python 3.10+ 紫外线 （提供 uvx)
• Node.js 20+（提供 node, npm, npx)

服务特定注意事项

• perf （perf-mcp）：需要Linux主机（推荐使用4.18+内核）和额外的分析工具/eBPF

（例如。 perf, sysstat, bcc-tools, bpftrace).还需要 perf-mcp 待建(cd perf-mcp && npm install && npm run build).

• cisco （cisco-mcp）：需要Python 3.11+、SSH客户端、密钥 ~/.ssh/cisco-key，以及对交换机mgmt子网的网络访问。
• playwright：需要安装Playwright浏览器（通常 npx playwright install 加上操作系统依赖于Linux）。
• kubernetes：需要通过访问群集 KUBECONFIG /kube上下文（以及集群使用的任何auth）。

设置

# Install all Python tools
./setup.sh --all

# Install tools only
./setup.sh --tools-only

# List available MCP services
./setup.sh --list-services

# Show help
./setup.sh --help

可用工具

MCP服务器

• 性能mcp -使用USE方法进行Linux性能故障排除（利用率、饱和度、错误）。21个工具，涵盖CPU分析、I/O延迟、网络健康、eBPF跟踪和事件分类。
• 思科mcp -通过SSH（VXLAN/EVPN结构）进行思科NX-OS交换机管理。

模板和库

• 工具样本 -用于创建具有可选MCP服务器集成的新Python CLI工具的模板。使用Click进行CLI，使用孵化器进行构建，使用pytest进行测试。
• mcp基地 -共享Python MCP服务器工厂。呼叫 create_server(name, tools, execute_func) 以获得一个准备运行的服务器。

参考技能（genAI/Skills/）

• mcp-builder/ -创建MCP服务器指南（Python/TypeScript）
• tool-development/ -工具构建模式
• coupling-evaluation/ -代码耦合分析
• technical-system-research/ -技术系统调查
• technical-report-writing/ -结构化技术报告
• uv-docker-packaging/ -基于UV的Docker容器化
• skill-creator/ -技能创作指南
• skill-evolver/ -通过遗传算法实现技能进化
• superpowers/ -完整的开发工作流程

创建新工具

使用 tool-sample/ 作为模板：

cp -r tool-sample my-new-tool
mv my-new-tool/my_tool my-new-tool/your_tool
mv my-new-tool/my_tool_mcp my-new-tool/your_tool_mcp
# Update pyproject.toml and implement your logic
cd my-new-tool && uv tool install -e . --force

看 tool-sample/README.md 完整的指南。

构建性能mcp

cd perf-mcp
npm install
npm run build
npm run test

MCP配置

所有MCP服务定义见 mcp_config.toml.使用 ./setup.sh --list-services 看看有什么可用的，或者 ./setup.sh --configure 以交互方式启用/禁用服务。

配置的MCP服务

• sequential_thinking -顺序思维MCP服务器
• memory -内存MCP服务器
• playwright -剧作家MCP服务器
• pyscn -Python代码质量分析器
• kubernetes -Kubernetes集群管理MCP服务器
• cisco -思科NX-OS交换机管理MCP服务器
• perf -MCP服务器Linux性能故障排除（USE方法）

可用技能（genAI/Skills/）

每项技能都是一组本地指令，存储在 genAI/skills/*/SKILL.md:

• coupling-evaluation
• mcp-builder
• skill-creator
• skill-evolver
• superpowers
• technical-report-writing
• technical-system-research
• tool-development
• uv-docker-packaging

发展

• 应用KISS/DRY原则
• 评论解释 *为什么*，不 *什么*
• Python：黑色（100个字符）、ruff、mypy、pytest
• TypeScript：biome、vitest、严格tsc
• 总是使用 uv 用于Python包管理

许可证

麻省理工学院