# Development configuration for mcp-nomad
## Environment Variables
### Nomad Server
```bash
export NOMAD_ADDR=http://localhost:4646
export NOMAD_TOKEN=your-token-here
```
### MCP Server
```bash
export MCP_TRANSPORT=stdio # or sse, streamable-http
export MCP_PORT=8080
```
### Development
```bash
export DEBUG=true
export LOG_LEVEL=debug
export SKIP_INTEGRATION=false
```
## Quick Start
### 1. Start Nomad Server (with Docker)
```bash
make start-nomad
```
### 2. Check Nomad Status
```bash
make nomad-status
```
### 3. Run MCP Server
```bash
# Stdio transport (for CLI tools)
make run-stdio
# SSE transport (for web clients)
make run-sse
# HTTP transport (for HTTP clients)
make run-http
```
### 4. Development Mode (with hot reload)
```bash
make dev
```
## Testing
### Run Tests
```bash
# All tests
make test
# Unit tests only
make test-unit
# Integration tests only
make test-integration
# With coverage
make test-coverage
```
### Start Nomad for Integration Tests
```bash
make start-nomad
make test-integration
make stop-nomad
```
## Building
### Quick Build
```bash
make quick-build
```
### Release Build
```bash
make build-all
```
### Docker Build
```bash
make docker-build
make docker-run
```
## Development Tools
### Install Tools
```bash
make install-tools
```
### Code Quality
```bash
make lint
make format
make security
```
## Troubleshooting
### Check Status
```bash
make status
make version
```
### Clean Everything
```bash
make clean-all
```
### Reset Dependencies
```bash
make deps
```
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/kocierik/mcp-nomad'
If you have feedback or need assistance with the MCP directory API, please join our Discord server