Skip to content

Add Model Context Protocol (MCP) Server #1

@machinellama

Description

@machinellama

Description of feature request

Implement a Model Context Protocol (MCP) stdio server for the finallyreact repo so AI coding assistants can query docs, search examples, and inspect component APIs to generate accurate code and snippets.


Expected behavior

  • stdio MCP server (Node + TypeScript preferred)
  • Index and serve:
    • Full-text search across README.md, translated-md/, and examples/
    • Topic/page lookup (return Markdown/MDX or plain text)
    • Component metadata: name, props (name/type/default/desc), source path, import snippet, example paths
    • Example lookup (source code + description)
  • Expose MCP tools (JSON-serializable):
    • list_topics() -> [{id,title,path}]
    • docs_lookup(path:string) -> {title, contentMarkdown, sourcePath}
    • docs_search(query:string, limit=5) -> [{title,path,snippet,score}]
    • list_components() -> [{name,summary,sourcePath}]
    • component_lookup(name:string) -> {name,props[],examples[],importStatement}
    • example_lookup(path:string) -> {code,description,dependencies}
  • Lightweight suggest_usage(intent:string) -> {component,propsSuggested,codeSnippet} (optional rule-based)

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requesthelp wantedExtra attention is needed

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions