Nicolas Koehl
403fa50b4f
- Add Server-Sent Events (SSE) endpoint for Claude Code MCP integration - Create MCP configuration for Claude Code CLI - Update tool configuration to support modern OpenAPI format - Add documentation for Claude Code integration options - Create CLAUDE.md guide for AI coding agents 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
27 lines
1.2 KiB
Markdown
27 lines
1.2 KiB
Markdown
# CLAUDE.md - Guide for AI Coding Agents
|
|
|
|
## Project Overview
|
|
Nomad MCP is a service that enables management of HashiCorp Nomad jobs via REST API, with Claude AI integration.
|
|
|
|
## Commands
|
|
- **Run server**: `uvicorn app.main:app --reload --host 0.0.0.0 --port 8000`
|
|
- **Tests**: `pytest` (all) or `pytest tests/test_nomad_service.py::test_job_lifecycle` (single)
|
|
- **Build docker**: `docker build -t nomad-mcp .`
|
|
- **Run docker**: `docker-compose up -d`
|
|
|
|
## Code Style
|
|
- **Imports**: Standard library → Third-party → Local modules (alphabetically)
|
|
- **Type annotations**: Required for all function parameters and returns
|
|
- **Error handling**: Use try/except with proper logging and HTTP exceptions
|
|
- **Logging**: Use Python's logging module with appropriate levels
|
|
- **API responses**: Return consistent JSON structures with Pydantic models
|
|
- **Docstrings**: Required for all functions and classes
|
|
- **Variables**: snake_case for variables, CamelCase for classes
|
|
|
|
## Structure
|
|
- `/app`: Main code (/routers, /schemas, /services)
|
|
- `/configs`: Configuration files
|
|
- `/static`: Frontend assets
|
|
- `/tests`: Test files
|
|
|
|
Always maintain backward compatibility with existing API endpoints. Follow REST principles. |