Symfony Mcp Server

by klapaudius

30 505 downloads Not rated yet MIT
GitHub

About

A Symfony package designed for building secure servers based on the Model Context Protocol, utilizing Server-Sent Events (SSE) and/or StreamableHTTP for real-time communication. It offers a scalable tool system tailored for enterprise-grade applications.

Details

License
MIT

Explore

| Ressources | Prompts | Tools | Discovery | Sampling | Roots | Elicitation |
|:----------:|:-------:|:-----:|:---------:|:--------:|:-----:|:-----------:|
| ✅ | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ |

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Symfony Mcp Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

    klp_mcp_server:
        enabled: true
        server:
            name: 'My MCP Server'
            version: '1.0.0'
        default_path: 'mcp'
        ping:
            enabled: true  # Read the warning section in the default configuration file before disable it
            interval: 30
        server_providers: ['streamable_http','sse']
        sse_adapter: 'cache'
        adapters:
            cache:
                prefix: 'mcp_sse_'
                ttl: 100
        tools:
            - KLP\KlpMcpServer\Services\ToolService\Examples\CodeAnalyzerTool     # Agentic tool sample
            - KLP\KlpMcpServer\Services\ToolService\Examples\HelloWorldTool
            - KLP\KlpMcpServer\Services\ToolService\Examples\ProfileGeneratorTool
            - KLP\KlpMcpServer\Services\ToolService\Examples\SearchResultsTool
            - KLP\KlpMcpServer\Services\ToolService\Examples\StreamingDataTool
            - KLP\KlpMcpServer\Services\ToolService\Examples\VersionCheckTool
        prompts:
            - KLP\KlpMcpServer\Services\PromptService\Examples\CodeReviewPrompt   # Agentic prompt sample
            - KLP\KlpMcpServer\Services\PromptService\Examples\HelloWorldPrompt
        resources:
            - KLP\KlpMcpServer\Services\ResourceService\Examples\HelloWorldResource
            - KLP\KlpMcpServer\Services\ResourceService\Examples\ProjectSummaryResource # Agentic resource sample
        resources_templates:
            - KLP\KlpMcpServer\Services\ResourceService\Examples\DynamicAnalysisResource # Agentic resource template sample
            - KLP\KlpMcpServer\Services\ResourceService\Examples\McpDocumentationResource
    
For more detailed explanations, you can open the default configuration file from that link.
   composer require klapaudius/symfony-mcp-server
   
klp_mcp_server:
    resource: '@KlpMcpServerBundle/Resources/config/routes.php'
    type: php

You're all done! Upon completing this setup, your project will include 3 new API endpoints:

- Streaming Endpoint for MCP Clients: GET /{default_path}/sse
- Request Submission Endpoint: POST /{default_path}/messages
- Streamable HTTP Endpoint: GET|POST /{default_path}

The project includes a Docker setup that can be used for development. The Docker setup includes Nginx, PHP-FPM with Redis extension, and Redis server.

For detailed instructions on how to set up and use the Docker containers, please refer to the Development Guidelines.

npx @modelcontextprotocol/inspector node build/index.js
``
This will typically open a web interface at
localhost:6274`. To test your MCP server:

Create powerful tools that AI agents can orchestrate:
- StreamableToolInterface: Real-time progress updates for long-running operations
- Multi-Result Support: Return text, images, audio, or resources
- Progress Notifications: Keep users informed during complex agent operations
- Dynamic Tool Discovery: Agents can discover and use tools based on capabilities

php bin/console make:mcp-tool MyCustomTool

php bin/console mcp:test-tool MyCustomTool --input='{"task":"analyze this code"}'
```

- MCP Inspector: Visualize and debug agent behavior
- Test Commands: Rapid agent development and testing

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "symfony mcp server": {
            "symfony-mcp-server": {
                "command": "npx",
                "args": [
                    "@modelcontextprotocol/inspector",
                    "node",
                    "build/index.js"
                ]
            }
        }
    }
}

McpServers

{
    "symfony-mcp-server": {
        "command": "npx",
        "args": [
            "@modelcontextprotocol/inspector",
            "node",
            "build/index.js"
        ]
    }
}

Run the MCP Inspector without installation

npx @modelcontextprotocol/inspector node build/index.js `` This will typically open a web interface at localhost:6274`. To test your MCP server:

5. Connect AI Clients

Your agents are now accessible to:
- 🤖 Claude Desktop / Claude.ai
- 🧠 Custom AI applications
- 🔗 Any MCP-compatible client

🏗️ Architecture for Agent Builders

Secure Agent Communication

- StreamableHTTP: Direct, secure agent-to-client communication - SSE (Server-Sent Events): Real-time updates for long-running agent tasks - No STDIO: Enterprise-safe, no system exposure

Scalable Agent Infrastructure

- Pub/Sub Messaging: Handle multiple agent sessions concurrently - Redis/Cache Adapters: Scale your agent platform horizontally - Progress Streaming: Real-time feedback for complex agent operations

Agent Development Tools

- MCP Inspector: Visualize and debug agent behavior - Test Commands: Rapid agent development and testing

Current Available MCP Features

| Ressources | Prompts | Tools | Discovery | Sampling | Roots | Elicitation |
|:----------:|:-------:|:-----:|:---------:|:--------:|:-----:|:-----------:|
| ✅ | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ |

🎓 Agent Development Resources

- 📖 Building Intelligent Tools: Complete guide to creating AI-powered tools
- 🧠 Sampling Documentation: Master agent reasoning capabilities
- 🎭 Prompt Engineering: Design agent behaviors and personalities
- 📚 Resource Management: Give agents access to knowledge

🌟 Join the Agent Revolution

Build the next generation of AI-powered applications with Symfony MCP Server. Your tools aren't just functions anymore – they're intelligent agents capable of reasoning, learning, and evolving.

Community

- 💬 GitHub Discussions: Share your agent creations
- 🐛 Issue Tracker: Report bugs and request features
- 🌟 Examples: Learn from working agents

📜 License

MIT License - Build freely!

📰 MCP Registries referencing

- https://mcpreview.com/mcp-servers/klapaudius/symfony-mcp-server
- https://mcp.so/server/symfony-mcp-server/klapaudius

---

Built with ❤️ by Boris AUBE and the contributors - Inspired by OP.GG/laravel-mcp-server

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Videos about Symfony Mcp Server

Relevant YouTube tutorials, setups, and demos