Skip to content

About

An MCP (Model Context Protocol) server implementation for interacting with S.EE services, providing capabilities for short URL management, text pasting, file sharing, and time utilities.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

S.EE MCP Server

An MCP (Model Context Protocol) server for S.EE. It exposes short URL, text sharing, file upload, QR code, bio page, analytics, and account APIs through Streamable HTTP.

Requirements

  • Go 1.25 or later
  • An S.EE API key

Tools

Short URLs and account

  • list_shorturl_domains, create_short_url, update_short_url, delete_short_url
  • list_short_url_history, get_short_url_visit_stats
  • list_tags, get_usage, check_api_token

Text sharing

  • list_text_domains, create_text, update_text, delete_text
  • list_text_history

Files

  • list_file_domains, upload_file, delete_file, list_file_history
  • get_private_file_download_url
  • create_large_file_upload, upload_large_file_chunk
  • get_large_file_upload_progress, complete_large_file_upload, cancel_large_file_upload

upload_file accepts either plain content or binary content_base64. Large files use resumable TUS sessions. Send Base64 chunks of at most 16 MiB to upload_large_file_chunk; the tool discovers the current server offset before each upload.

QR codes and bio pages

  • create_qrcode, delete_qrcode, list_qrcode_history
  • create_bio_page, update_bio_page, delete_bio_page, list_bio_page_history

Utilities

  • get_current_time

The server also provides domain and status resources plus prompt templates for common sharing workflows. Structured S.EE responses are returned as JSON so MCP clients can consume IDs, URLs, metadata, and pagination results reliably.

Build

make build

Or build directly:

go build -o bin/cli-mcp-server .

Use make build-all to produce binaries for all supported platforms. Build output is written to bin/.

Configuration

Flag Environment variable Description Default
-api-key SEE_API_KEY S.EE API key (required) None
-api-base SEE_API_BASE S.EE API base URL SDK default
-port None Streamable HTTP port 30101
-rate-limit None Requests per second; non-positive disables limiting 1.0
-rate-burst None Rate limiter burst size 5

Command-line values take precedence over environment variables.

Run

export SEE_API_KEY="your-api-key"
./bin/cli-mcp-server

Or pass configuration directly:

./bin/cli-mcp-server -api-key "your-api-key" -port 30101

Configure an MCP client to use the Streamable HTTP endpoint:

http://localhost:30101

MCP client configuration

MCP workflow

License

Licensed under the MIT License.

Copyright (c) 2026 S.EE Development Team

About

An MCP (Model Context Protocol) server implementation for interacting with S.EE services, providing capabilities for short URL management, text pasting, file sharing, and time utilities.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

⌂