Download the PHP package seolinkmap/waasup without Composer
On this page you can find all versions of the php package seolinkmap/waasup. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download seolinkmap/waasup
More information about seolinkmap/waasup
Files in seolinkmap/waasup
Package waasup
Short Description Website as a Server unleashing Power (WaaSuP) - Production-ready SaaS Model Context Protocol (MCP) server for PHP
License MIT
Informations about the package waasup
WaaSuP with your website
WaaSuP (Website as a Server unleashing Power) - A production-ready, SaaS-oriented Model Context Protocol (MCP) server implementation for PHP. Built with enterprise-grade features including OAuth 2.1 authentication, real-time Server-Sent Events (SSE), and comprehensive tool management.
🚀 Try It Live
Want to see WaaSuP in action? Try our live demo at seolinkmap.com/mcp-repo with your favorite LLM or agentic tool! This demo showcases the server's capabilities with a public Website-as-a-Server (MCP authless).
Built by SEOLinkMap - The public production implementation powering chat and agentic tools to use with our existing SEO intelligence platform.
✨ Features
- 🔐 OAuth 2.1 Authentication - Complete OAuth flow with token validation and scope management
- ⚡ Real-time SSE Transport - Server-Sent Events for instant message delivery
- 🛠️ Flexible Tool System - Easy tool registration with both class-based and callable approaches
- 🏢 Multi-tenant Architecture - Agency/user context isolation for SaaS applications
- 📊 Production Ready - Comprehensive logging, error handling, and session management
- 🔌 Framework Agnostic - PSR-compliant with Slim Framework integration included
- 💾 Database & Memory Storage - Multiple storage backends for different deployment scenarios
- 🌐 CORS Support - Full cross-origin resource sharing configuration
Requirements
- PHP 8.1 or higher
- Composer
- Database (MySQL/PostgreSQL recommended for production)
Installation
Database Setup
-
Import the database schema:
-
Create your first agency (or configure your existing database):
- Create an OAuth token:
Quick Start
Basic Server Setup
Adding Tools
Built-in Tools
The server includes several built-in tools that you can register:
ping
- Test connectivity and response timesserver_info
- Get server information and capabilities
Callable Tool (Simple)
Class-based Tool (Advanced)
Adding Prompts
Adding Resources
OAuth 2.1 Flow
Discovery
-
Client discovers endpoints:
-
Client requests authorization:
- Client exchanges code for token:
MCP Protocol Usage
SSE Connection & Requests
Configuration
Server Configuration
Database Storage
Memory Storage (Development/Testing)
Logging
With Monolog
Custom Logger
Framework Integration
Laravel
Service Provider Registration
Add the service provider to your Laravel application:
Creating an MCP Controller
Route Registration
Advanced Laravel Integration
Standalone (PSR-7)
Advanced Usage
Custom Authentication
Tool Annotations
Session Management
Built-in Tools
The server includes several built-in tools for testing and basic functionality that you can register:
Ping Tool
Server Info Tool
API Reference
MCP Methods
Method | Description |
---|---|
tools/list |
List all available tools |
tools/call |
Execute a specific tool |
prompts/list |
List all available prompts |
prompts/get |
Get a specific prompt |
resources/list |
List all available resources |
resources/read |
Read a specific resource |
resources/templates/list |
List resource templates |
initialize |
Initialize MCP session |
ping |
Health check endpoint |
Error Codes
Code | Description |
---|---|
-32000 |
Authentication required |
-32001 |
Session required |
-32600 |
Invalid Request |
-32601 |
Method not found |
-32602 |
Invalid params |
-32603 |
Internal error |
-32700 |
Parse error |
Testing
Example Test
Security
- Token Validation: All requests require valid OAuth tokens
- Scope Checking: Configurable scope validation for fine-grained access
- SQL Injection: All database queries use prepared statements
- Session Security: Cryptographically secure session ID generation
- CORS: Configurable CORS policies for cross-origin requests
Deployment
Docker
Nginx Configuration
Contributing
We welcome contributions! This server is actively used in production at SEOLinkMap where it powers our SEO intelligence platform.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature
) - Make your changes
- Add tests for new functionality
- Ensure all tests pass (
composer test
) - Commit your changes (
git commit -m 'Add amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
Development
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
- Anthropic for the Model Context Protocol specification
- PHP-FIG for the PSR standards
- Slim Framework for the excellent HTTP foundation
Support & Community
- 🌐 Live Demo: https://seolinkmap.com/mcp-repo (use WaaSuP server to chat with WaaSuP repository... help, install, tool building)
- 📖 Documentation: GitHub Wiki
- 🐛 Issues: GitHub Issues
- 💬 Discussions: GitHub Discussions
Built with ❤️ by SEOLinkMap for the MCP community.
All versions of waasup with dependencies
psr/http-message Version ^1.0|^2.0
psr/http-server-middleware Version ^1.0
psr/http-factory Version ^1.0
psr/log Version ^1.0|^2.0|^3.0