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 using PHP (WaaSuP) - Production-ready SaaS Model Context Protocol (MCP) server for PHP
License MIT
Rated 5.00 based on 1 reviews
Informations about the package waasup
WaaSuP with your website
WaaSuP (Website as a Server using PHP) - 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? Connect to our live demo MCP server with your favorite LLM or agentic tool!
💬 Chat With This Repository
Get instant help with:
- ✅ Installation guidance - Step-by-step setup for your environment
- ⚙️ Configuration assistance - Database setup, OAuth, framework integration
- 🛠️ Custom tool development - Build tools specific to your use case
- 🐛 Troubleshooting - Debug issues with access to the full codebase
- 📚 Code exploration - Understand how features work under the hood
The MCP server has access to our entire repository, documentation, and examples. Ask it anything!
📡 Live MCP Server
https://seolinkmap.com/mcp-repo
This public MCP endpoint showcases the server's capabilities with a complete Website-as-a-Server implementation (authless).
🔗 Need Help Connecting?
New to MCP servers? Learn how to connect: How to Connect to MCP Servers
Once connected, you can explore our entire repository through chat and get real-time help with WaaSuP installation and configuration.
Built by SEOLinkMap - This is our production "web server for chat and agentics" powering AI access to our entire SEO intelligence platform.
✨ Features
- 🔐 OAuth 2.1 Authentication - Complete OAuth flow with RFC 8707 Resource Indicators support for MCP 2025-06-18
- ⚡ Multi-Transport Support - Server-Sent Events (SSE) and Streamable HTTP for real-time 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 and Laravel integration included
- 💾 Database & Memory Storage - Multiple storage backends for different deployment scenarios
- 🌐 CORS Support - Full cross-origin resource sharing configuration
- 🎵 Audio Content Support - Handle audio content in tools and prompts (MCP 2025-03-26+)
- 📝 Structured User Input - Elicitation support for collecting structured data (MCP 2025-06-18)
- 🔄 Progress Notifications - Real-time progress updates with version-aware messaging
- 🏷️ Tool Annotations - Rich tool metadata for better LLM understanding (MCP 2025-03-26+)
- 📦 JSON-RPC Batching - Efficient batch request processing (MCP 2025-03-26)
Requirements
- PHP 8.1 or higher
- Composer
- Database (MySQL/PostgreSQL recommended for production)
MCP Protocol Compliance
WaaSuP implements the complete MCP specification across multiple protocol versions with automatic feature gating:
Feature Matrix Summary
Feature | 2024-11-05 | 2025-03-26 | 2025-06-18 |
---|---|---|---|
Tools | ✅ | ✅ | ✅ |
Prompts | ✅ | ✅ | ✅ |
Resources | ✅ | ✅ | ✅ |
Sampling | ✅ | ✅ | ✅ |
Roots | ✅ | ✅ | ✅ |
Ping | ✅ | ✅ | ✅ |
Progress Notifications | ✅ | ✅ | ✅ |
Tool Annotations | ❌ | ✅ | ✅ |
Audio Content | ❌ | ✅ | ✅ |
Completions | ❌ | ✅ | ✅ |
JSON-RPC Batching | ❌ | ✅ | ❌ |
OAuth 2.1 | ❌ | ❌ | ✅ |
Elicitation | ❌ | ❌ | ✅ |
Structured Outputs | ❌ | ❌ | ✅ |
Resource Links | ❌ | ❌ | ✅ |
Resource Indicators (RFC 8707) | ❌ | ❌ | ✅ (Required) |
Installation
Database Setup
-
Import the database schema:
-
Create your first agency:
- Create an OAuth token:
Quick Start
Basic Server Setup
Adding Tools
Simple Callable Tool
Built-in Tools
Adding Prompts and Resources
Framework Integration
Laravel Integration
Add the service provider to your Laravel application:
Register routes and use the provided controller pattern. See the full Laravel integration example in the /examples
directory.
Standalone (PSR-7)
Configuration
Server Configuration
Storage Options
Database Storage (Production)
Memory Storage (Development/Testing)
OAuth 2.1 & Authentication
WaaSuP implements complete OAuth 2.1 with RFC 8707 Resource Indicators for MCP 2025-06-18:
- Authorization Code Flow with PKCE (required)
- Resource Indicators for token binding to specific MCP endpoints
- Social Authentication via Google, LinkedIn, and GitHub
- Token Validation with audience claims and scope checking
- Discovery Endpoints for client configuration
Social authentication can be configured for each provider:
Advanced Features
Audio Content Handling (MCP 2025-03-26+)
Structured User Input (MCP 2025-06-18)
Progress Notifications
API Reference
MCP Methods
Method | Description | Supported Versions |
---|---|---|
initialize |
Initialize MCP session | All |
ping |
Health check | All |
tools/list |
List available tools | All |
tools/call |
Execute a tool | All |
prompts/list |
List available prompts | All |
prompts/get |
Get a prompt | All |
resources/list |
List available resources | All |
resources/read |
Read a resource | All |
completion/complete |
Get completions for arguments | All |
sampling/createMessage |
Request LLM sampling | All |
roots/list |
List available root directories | All |
elicitation/create |
Request user input | 2025-06-18 |
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
Security
- Token Validation: All requests require valid OAuth tokens with proper audience validation
- Scope Checking: Configurable scope validation for fine-grained access control
- SQL Injection Protection: All database queries use prepared statements
- Session Security: Cryptographically secure session ID generation
- CORS Configuration: Configurable CORS policies for cross-origin requests
- DNS Rebinding Protection: Origin header validation for localhost endpoints
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
- modelcontextprotocol.io for official MCP documentation and schema
- 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