y-server by luohy15 - MCP Server

y-server 🚀

A Cloudflare Worker-based MCP (Model Context Protocol) Server with streamable HTTP transport support. This server provides various tools and integrations for AI assistants to interact with external services and APIs.

This server is designed to work with y-gui, a web-based graphical interface for AI chat interactions with powerful MCP integrations.

🧰 Tools

y-server extends AI capabilities through the Model Context Protocol by providing a suite of tools that allow AI assistants to interact with various external services and APIs:

Category	Tools	Description
📅 Calendar	Google Calendar	Create, read, update, and delete calendar events
📝 Editor	S3	S3-based file editing (replace)
📧 Email	Gmail	Query, read, and reply to emails; Create and manage email drafts; Handle email attachments
🌐 Fetch & Scrape	Cloudflare, Firecrawl	Cloudflare-powered web fetching; Firecrawl web scraping capabilities
📂 File	E2B, S3	File operations (list, read, write)
💰 Finance	AlphaVantage	Financial data retrieval
🖼️ Image	Image Router	Image generation and routing
🧪 Sandbox	E2B	Code execution and command sandboxing
🔎 Search	Tavily, Exa, Brave	Tavily search and information extraction; Exa search and content retrieval; Brave web search

📦 Installation

📋 Prerequisites

Node.js (latest LTS version recommended)
Cloudflare account with Workers and R2 access

🔧 Setup

Clone the repository

git clone https://github.com/yourusername/y-server.git
cd y-server

Install dependencies

npm install

Configure your environment variables in the Cloudflare dashboard or using .dev.vars for local development

⚙️ Configuration

☁️ Cloudflare Worker Configuration

The project uses wrangler.toml for Cloudflare Worker configuration:

name = "y-server"
main = "src/index.ts"
compatibility_flags = [ "nodejs_compat" ]
compatibility_date = "2024-09-23"

[[r2_buckets]]
binding = "CDN_BUCKET"
bucket_name = "cdn-yovy-app"

[dev]
port = 8788
ip = "localhost"
local_protocol = "http"

🔐 Required Environment Variables

CLOUDFLARE_ACCOUNT_ID: Your Cloudflare account ID
CLOUDFLARE_BROWSER_RENDER_API_TOKEN: API token for Cloudflare Browser Rendering
Other service-specific credentials (Google API, Brave API, etc.)

💻 Development

🏠 Local Development

Start the development server:

npm run dev

This will start the worker on http://localhost:8788

🏗️ Build

Build the project:

npm run build

🚀 Deploy

Deploy to Cloudflare Workers:

npm run deploy

🔌 MCP Integration

This server implements the Model Context Protocol, allowing AI assistants to use the provided tools through a standardized interface. It uses a streamable HTTP transport that enables efficient communication with AI models.

🧩 Integration with y-gui

y-server is designed to work as an MCP server for y-gui, a web-based graphical interface for AI chat interactions. The y-gui client provides:

💬 Interactive chat interface with AI models
🤖 Support for multiple bot configurations
🔗 Comprehensive MCP integration system
🔒 Secure authentication with Auth0 and Google login
🌓 Dark/light theme support
📝 All chat data stored in Cloudflare R2

To connect y-server with y-gui:

Deploy your y-server instance
In y-gui, configure a new MCP server with your y-server URL
Enable the desired tools in your bot configuration

For more information, visit the y-gui repository.

There's also a CLI version available: y-cli.

📁 Project Structure

src/
├── index.ts                 # Main entry point
├── tools/                   # All MCP tools
│   ├── calendar/            # Calendar tools (Google)
│   ├── editor/              # Editor tools (S3)
│   ├── email/               # Email tools (Gmail)
│   ├── fetch/               # Web fetch tools
│   ├── image/               # Image tools
│   └── search/              # Search tools (Brave, Tavily, Exa)
├── transport/               # HTTP transport implementation
└── types/                   # TypeScript type definitions

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.