research-publish

마크다운 AI 연구 항목을 Convex aiResearch 테이블에 게시하기 위한 MCP 서버입니다.

서버는 시작 시 환경이 고정됩니다:

-dev: 개발 배포 자격 증명에 서버를 바인딩합니다.
-prod: 프로덕션 배포 자격 증명에 서버를 바인딩합니다.

MCP 호스트는 대상 배포의 .convex.site URL과 쓰기 키를 환경 변수를 통해 제공해야 합니다.

필수 백엔드 계약

이 MCP는 다음 위치에 보호된 Convex HTTP 엔드포인트가 있다고 가정합니다:

POST /studio/ai-research

요청 본문:

{
  "title": "Release notes",
  "body": "# Heading\n\nMarkdown body",
  "model": "gpt-5.4",
  "prompt": "Summarize the migration plan"
}

환경 변수

CONVEX_SITE_URL
CONVEX_WRITE_KEY

선택 사항:

CONVEX_PUBLISH_PATH: 기본값은 /studio/ai-research입니다.

MCP 호스트 구성 예시

{
  "mcpServers": {
    "research-publish-dev": {
      "command": "npx",
      "args": ["-y", "research-publish", "-dev"],
      "env": {
        "CONVEX_SITE_URL": "https://your-dev-deployment.convex.site",
        "CONVEX_WRITE_KEY": "your-dev-write-key"
      }
    },
    "research-publish-prod": {
      "command": "npx",
      "args": ["-y", "research-publish", "-prod"],
      "env": {
        "CONVEX_SITE_URL": "https://your-prod-deployment.convex.site",
        "CONVEX_WRITE_KEY": "your-prod-write-key"
      }
    }
  }
}