Download the PHP package eduardocruz/laravel-telescope-mcp-server-mvp without Composer
On this page you can find all versions of the php package eduardocruz/laravel-telescope-mcp-server-mvp. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download eduardocruz/laravel-telescope-mcp-server-mvp
More information about eduardocruz/laravel-telescope-mcp-server-mvp
Files in eduardocruz/laravel-telescope-mcp-server-mvp
Package laravel-telescope-mcp-server-mvp
Short Description A PHP MCP server for Laravel Telescope integration with Cursor IDE
License MIT
Informations about the package laravel-telescope-mcp-server-mvp
Laravel Telescope MCP Server (PHP)
A Model Context Protocol (MCP) server built in PHP that provides AI agents with direct access to Laravel Telescope data, enabling efficient debugging and analysis of Laravel applications.
Project Overview
This project is a PHP implementation of a Laravel Telescope MCP server, inspired by bradleybernard/TelescopeMCP but built using the php-mcp/server library instead of Python.
Key Goals
- Proof of Concept: Create the most basic MCP server to demonstrate Laravel Telescope integration
- PHP Native: Built entirely in PHP using the php-mcp/server library
- Cursor Integration: Optimized for Cursor IDE with deeplink support for seamless development workflow
- Minimal Viable Product: Focus on core functionality to get something working quickly
Features (Planned)
Core MCP Tools
telescope_requests
- List recent HTTP requests from Telescopetelescope_search
- Search requests with basic filters (status, method, URI pattern)telescope_request_details
- Get detailed information about a specific requesttelescope_queries
- View database queries for a specific request
Cursor Integration
- Deeplink support for quick server startup and debugging
- Development-friendly configuration
- Easy setup for Laravel projects
Architecture
Quick Start (Planned)
Prerequisites
- PHP 8.1+
- Composer
- Laravel application with Telescope installed
- Cursor IDE
Installation
Configuration
Running the Server
Option 1: Direct PHP Execution
Option 2: Using Composer Script
Option 3: Using PHPX (Recommended)
If you have PHPX installed:
Cursor Deeplink Integration
To integrate with Cursor, you'll need to create a deeplink configuration. Here's the MCP server configuration for Cursor:
For Cursor IDE Settings
Add this to your Cursor MCP configuration:
Alternative: Using PHPX
Generating Cursor Deeplink
- Get your server configuration JSON
- Use
JSON.stringify()
to convert it and base64 encode it - Create the deeplink:
cursor://mcp/install?name=telescope&config=BASE64_ENCODED_CONFIG
Example helper script for generating the deeplink:
## Development Roadmap
### Phase 1: Basic MCP Server
- [x] Project setup and README
- [ ] Basic MCP server using php-mcp/server
- [ ] Database connection to Laravel Telescope tables
- [ ] Simple request listing tool
### Phase 2: Core Tools
- [ ] Request search and filtering
- [ ] Request detail retrieval
- [ ] Query analysis tool
- [ ] Basic error handling
### Phase 3: Cursor Integration
- [ ] Deeplink configuration
- [ ] Development workflow optimization
- [ ] Documentation for Cursor setup
### Phase 4: Enhancement
- [ ] Performance optimization
- [ ] Additional Telescope data types (jobs, cache, etc.)
- [ ] Better error messages and debugging
## Technical Stack
- **Language**: PHP 8.1+
- **MCP Library**: [php-mcp/server](https://github.com/php-mcp/server)
- **Database**: MySQL/MariaDB (Laravel Telescope tables)
- **IDE Integration**: Cursor with deeplink support
## Inspiration
This project draws inspiration from:
- [bradleybernard/TelescopeMCP](https://github.com/bradleybernard/TelescopeMCP) - Python implementation
- [php-mcp/server](https://github.com/php-mcp/server) - PHP MCP server library
## Why PHP?
- Native integration with Laravel ecosystem
- Leverages existing PHP knowledge for Laravel developers
- Direct access to Laravel's database structure and conventions
- Easier deployment alongside existing PHP/Laravel infrastructure
## Contributing
This is a proof-of-concept project focused on getting a minimal viable product working. Contributions welcome once the basic functionality is established.
## License
MIT License - see LICENSE file for details.
---
**Status**: 🚧 Early Development - Proof of Concept Phase
**Next Steps**: Set up basic MCP server structure using php-mcp/server library.