HarperFast / HarperFast/harper

[Epic] MCP server & OpenAPI schema generation

Open
#2,102 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
JavaScript
Stars
89
Forks
10
Avg merge
2d 2h
Merged PRs (30d)
205

Description

Harper's MCP server and the schema generation it shares with OpenAPI. This epic gives that work a live parent.

## Why this exists

#1349 (`MCP server: complete the protocol surface`) was the de facto MCP epic, and it is **closed as completed** while still holding three open children — #1107, #1368, and #1548. Open work under a closed parent doesn't show up in any epic-progress view, so those are adopted here along with the MCP issues that were never parented at all.

## Scope

**In:** the MCP protocol surface (sessions, subscriptions, streaming, protocol-era handling), tool and resource registration, and the schema type mapping shared between MCP and OpenAPI.

**Out:** the operations API itself (#1681) — MCP exposes it, but defects in the operations are that epic's. General component-authoring concerns (#1678) unless MCP-specific.

_Created during backlog triage; the child issues keep their own priorities and milestones._

Contributor guide

Open the contributing guide

Research direction

This is a parent epic rather than a self-contained task. Start by reading the adopted child issues #1107, #1368, and #1548, along with the unparented MCP issues, and use the stated in-scope protocol and schema areas to identify a concrete task. Done means the relevant child work is completed without expanding into the excluded operations API or general component authoring.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, nodejs, openapi
Domain
api, backend-api-design
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.