Skip to content

Comments

Provided Full Supports for SSE and Streamable-HTTP Transports and Refactor README#193

Merged
RyanNg1403 merged 8 commits intomainfrom
add/refactor-readme
Aug 9, 2025
Merged

Provided Full Supports for SSE and Streamable-HTTP Transports and Refactor README#193
RyanNg1403 merged 8 commits intomainfrom
add/refactor-readme

Conversation

@RyanNg1403
Copy link
Collaborator

Summary

  • Add first-class MCP server support for SSE and Streamable-HTTP transports
  • Refactor README to be concise and push deep-dive details into dedicated docs in @docs/

What’s new

  • SSE transport
    • New dedicated server: src/app/mcp/mcp_sse_server.ts
    • API mode integration: GET /api/mcp/sse (establish SSE), POST /api/mcp?sessionId=... (messages)
    • CLI: cipher --mode mcp --mcp-transport-type sse --mcp-port 3000
    • API mode: cipher --mode api --mcp-transport-type sse --port 3001
  • Streamable-HTTP transport
    • New server: src/app/mcp/mcp_streamable_http_server.ts
    • CLI: cipher --mode mcp --mcp-transport-type streamable-http --mcp-port 3001

CLI and config

  • Defaults: cipher --mode mcp uses stdio; --mcp-transport-type selects stdio | sse | streamable-http
  • Exact-optional typing compliance for transport options; consistent returns in route handlers

Documentation

  • README streamlined:
    • Introduced dropdowns for CLI usage, basic config, and env vars
    • Light emoji pass for friendliness (kept minimal)
    • Pointed readers to specific, expanded guides in @docs/ (CLI Reference, MCP Integration, Vector Stores, etc.)
  • CLI Reference updated with accurate provider list and HTTP/SSE endpoints

How to test

  • SSE (stdio remains default)
    • cipher --mode mcp --mcp-transport-type sse --mcp-port 3000
    • Or via API mode: cipher --mode api --mcp-transport-type sse --port 3001
  • Streamable-HTTP
    • cipher --mode mcp --mcp-transport-type streamable-http --mcp-port 3001

Impact

  • Enables HTTP-based MCP connectivity for IDEs/clients that prefer SSE or streamable patterns
  • Improves onboarding and doc navigation without losing depth (now centralized in @docs/)

@RyanNg1403 RyanNg1403 merged commit f5fbf56 into main Aug 9, 2025
5 checks passed
@RyanNg1403 RyanNg1403 deleted the add/refactor-readme branch August 9, 2025 13:09
Ptah-CT pushed a commit to DerAuctor/ct-cipher that referenced this pull request Oct 2, 2025
Provided Full Supports for SSE and Streamable-HTTP Transports and Refactor README
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant