symfony-mcp-server: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is a Symfony bundle that enables developers to seamlessly add a Model Context Protocol (MCP) server to their Symfony applications. The main goal is to provide a production-ready implementation following the official MCP specifications at https://modelcontextprotocol.io/specification/2025-03-26.

The bundle allows Symfony applications to expose tools, resources, and prompts that can be consumed by Large Language Models (LLMs) through secure transport protocols (SSE and StreamableHTTP), avoiding the security risks of STDIO transport in enterprise environments.

Commands

Testing

# Run all tests
vendor/bin/phpunit

# Run a specific test file
vendor/bin/phpunit tests/path/to/TestFile.php

# Generate code coverage
vendor/bin/phpunit --coverage-html build/coverage

# Run PHPStan static analysis
vendor/bin/phpstan analyse

Development Tools

# Create a new MCP tool
php bin/console make:mcp-tool MyCustomTool

# Test a specific MCP tool
php bin/console mcp:test-tool MyCustomTool

# Test tool with specific input
php bin/console mcp:test-tool MyCustomTool --input='{"param":"value"}'

# List all available tools
php bin/console mcp:test-tool --list

MCP Inspector

# Run the MCP Inspector for visual testing
npx @modelcontextprotocol/inspector node build/index.js

Architecture Overview

Package Structure

This is a Symfony bundle that implements the Model Context Protocol (MCP) server. It provides:

• Dual Transport Support: Both SSE (Server-Sent Events) and StreamableHTTP protocols
• Tool System: Extensible framework for creating MCP tools that LLMs can invoke
• Resource System: Management of resources that can be exposed to LLM clients
• Prompt System: Pre-defined conversation starters and templates for LLM interactions
• Progress Notifications: Real-time progress updates for long-running operations