Skip to content
This repository was archived by the owner on Oct 19, 2026. It is now read-only.

Add Speakeasy docs MCP server - #107

Closed
ThomasRooney wants to merge 8 commits into
mainfrom
docs-mcp-setup
Closed

ThomasRooney wants to merge 8 commits into
mainfrom
docs-mcp-setup

Conversation

@ThomasRooney

Copy link
Copy Markdown
Member

Summary

  • Docs MCP search server over this repository's five content hubs (docs, guides, api-design, mcp, openapi), modeled on speakeasy-sdks/google-gemini-docs-mcp without the terraform deployment
  • Build-time corpus copy renames .mdx to .md (no JSX stripping) into gitignored dist/corpus; FTS-only index (no API keys)
  • npm scripts for stdio and Streamable HTTP (port 20310), self-contained Docker image, compose stack with the Gram tunnel agent
  • Design spec: specs/2026-07-31-docs-mcp-design.md

Test plan

  • npm test (validate + index build)
  • curl /healthz + speakeasy_search_docs smoke over HTTP
  • docker build + containerized healthz
  • docker compose config validation

@ThomasRooney
ThomasRooney requested a review from a team as a code owner July 31, 2026 17:35

@simplesagar simplesagar left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice! Can we move to marketing-site ? This repo may be closed down soon.

@ThomasRooney

Copy link
Copy Markdown
Member Author

Superseded — this setup is being remade on speakeasy-api/marketing-site (the source repo).

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants