[中文](README_zh.md) | English
# C++ Style Guide MCP Server
Enforce consistent C++ style and best practices across your codebase. Analyze naming conventions, memory safety, and const correctness, and get actionable modernization suggestions up to C++23. Accelerate reviews with ready-made prompts and quick access to curated guidelines.
## Tools
| Tool | Description |
|------|-------------|
| `check_naming` | Validate C++ identifiers (variables, classes, functions, etc.) against naming conventions |
| `check_include_guard` | Verify header file include guards or `#pragma once` usage |
| `analyze_memory_safety` | Detect memory leaks, dangling pointers, and unsafe memory patterns |
| `suggest_modern_cpp` | Get modernization suggestions targeting C++11 through C++23 |
| `check_const_correctness` | Find missing `const` qualifiers on member functions, parameters, and variables |
## Resources
| URI | Description |
|-----|-------------|
| `cpp-style://naming/{category}` | Naming convention reference (variable, class, function, namespace, …) |
| `cpp-style://best-practices/{topic}` | Best practice guides (memory, exceptions, templates, concurrency, …) |
| `cpp-style://standard/{version}` | C++ standard feature docs (cpp11 – cpp23) |
| `cpp-style://examples/{pattern}` | Design pattern examples (RAII, Pimpl, Factory, Observer, …) |
## Prompts
| Prompt | Description |
|--------|-------------|
| `code_review` | Code review template (general / performance / safety / readability / modern) |
| `refactor_suggestion` | Refactoring guide targeting a specific C++ standard |
## Usage
### Connect via Smithery (recommended)
```bash
npx -y @smithery/cli install @SongJiangzhou/cpp_guidelines --client claude
```
### MCP endpoint (HTTP / streamable-http)
```
https://cpp-style-guide-mcp.fly.dev/mcp
```
### Local installation
```bash
git clone https://github.com/SongJiangzhou/cpp_guidelines_mcp.git
cd cpp_guidelines_mcp
uv sync
uv run mcp run cpp_style_server.py
```
Add to your MCP client config:
```json
{
"mcpServers": {
"cpp-style": {
"command": "uv",
"args": ["run", "mcp", "run", "cpp_style_server.py"],
"cwd": "/path/to/cpp_guidelines_mcp"
}
}
}
```
## Examples
```
# Check a variable name
check_naming("myVariable", "variable")
# Analyze memory safety
analyze_memory_safety("void f(int* p) { delete p; p->run(); }")
# Modernize code to C++17
suggest_modern_cpp("for (int i=0; i<v.size(); i++) {...}", "cpp17")
# Check const correctness
check_const_correctness("class Foo { int getValue() { return x; } int x; };")
# Access naming convention docs
Resource: cpp-style://naming/all
# Access memory best practices
Resource: cpp-style://best-practices/memory
```
## Project Structure
```
cpp_guidelines_mcp/
├── cpp_style_server.py # MCP server entry point
├── cpp_style/
│ ├── tools/ # 5 analysis tools
│ ├── resources/ # 4 reference resource categories
│ ├── prompts/ # 2 prompt templates
│ └── data/ # JSON knowledge base
├── fly.toml # Fly.io deployment config
├── Dockerfile # Container image
└── smithery.yaml # Smithery config (local stdio mode)
```
## Tech Stack
- Python >= 3.12
- [FastMCP](https://github.com/jlowin/fastmcp) >= 1.21.0
- [uv](https://github.com/astral-sh/uv) package manager
- Deployed on [Fly.io](https://fly.io)
## License
[MIT](LICENSE)
## Links
- GitHub: https://github.com/SongJiangzhou/cpp_guidelines_mcp
- Issues: https://github.com/SongJiangzhou/cpp_guidelines_mcp/issues
- Smithery: https://smithery.ai/server/SongJiangzhou/cpp_guidelines
