Skip to content

Add stdio transport entry point (src/stdio.js) - #2

Merged
publora-team merged 1 commit into
mainfrom
add-stdio-transport
Jun 30, 2026
Merged

Add stdio transport entry point (src/stdio.js)#2
publora-team merged 1 commit into
mainfrom
add-stdio-transport

Conversation

@publora-team

Copy link
Copy Markdown
Member

What

Adds src/stdio.js — a stdio entry point for the MCP server.

It reuses the existing createApiClient + registerTools from src/index.js (no logic duplicated) and connects a StdioServerTransport. Also adds a start:stdio script and a publora-mcp-stdio bin.

Why

  • The HTTP server only speaks Streamable HTTP. Some MCP clients (and tooling like Glama's mcp-proxy) expect a stdio server. This adds that without changing the HTTP path.
  • Enables local use in Claude Desktop / Cursor (npx/node src/stdio.js), and unblocks the Glama quality Release (mcp-proxy wraps a stdio server).

Safety

  • src/index.js (the live mcp.publora.com server) is unchanged. This only adds a new file + additive package.json entries.
  • Tested locally: initialize + tools/list over stdio returns all 18 tools. stdout stays clean (logs go to stderr).
  • API key read from PUBLORA_API_KEY; introspection (tools/list) works without a key.

Follow-up (not in this PR)

zod is used in src/index.js but not declared in dependencies (works via npm hoisting). Worth declaring explicitly in a separate PR.

Adds a stdio entry point that reuses the existing createApiClient +
registerTools from src/index.js and connects a StdioServerTransport.
The HTTP server (src/index.js) is unchanged. Enables local use in MCP
clients (Claude Desktop, Cursor) and wrapping by mcp-proxy (Glama).
@publora-team
publora-team merged commit 98ecd11 into main Jun 30, 2026
0 of 4 checks passed
@publora-team
publora-team deleted the add-stdio-transport branch June 30, 2026 11:47
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