[PR #5] Add MCP documentation page with API endpoints for content #7

Closed
opened 2025-12-17 14:22:56 +01:00 by arthur · 0 comments
Owner

Original Pull Request: https://github.com/ArthurDanjou/artapi/pull/5

State: closed
Merged: Yes


Adds a documentation page for the ArtMCP server, displayed when accessing the MCP endpoint in a browser. Documents all available tools, prompts, and resources. Also adds REST API endpoints to fetch content and updates MCP resources to use these endpoints.

Changes

  • content/documentation.md - Comprehensive markdown documentation covering:

    • 6 tools (activity, resume-link, stats, status-page, uses-by-category, weather)
    • 11 prompts with input schemas where applicable
    • 9 resources with URIs and descriptions
    • MCP client integration examples and REST API endpoints
  • content.config.ts - Added documentation collection

  • app/pages/index.vue - Replaced hello page with documentation renderer

  • New API endpoints in /server/api/:

    • profile.get.ts - Profile information
    • contact.get.ts - Contact information
    • skills.get.ts - Technical skills
    • experiences.get.ts - Work experiences (sorted by startDate descending)
    • education.get.ts - Education background (sorted by startDate descending)
    • projects.get.ts - Projects portfolio
    • languages.get.ts - Spoken languages
    • hobbies.get.ts - Hobbies and interests
    • uses.get.ts - Tech stack and tools organized by category
  • Updated MCP resources - All 9 MCP resources (profile, contact, skills, experiences, education, projects, languages, hobbies, uses) now use $fetch('/api/{endpoint}') instead of duplicating the query logic, ensuring consistency between REST API and MCP resources.

Original prompt

Write a documentation for my mcp into a markdown page named 'documentation.md' in the content directory. And query it on the main page to provide a documentation when accessing the mcp on the browser. I want it to talk about tools, prompts and resources


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

**Original Pull Request:** https://github.com/ArthurDanjou/artapi/pull/5 **State:** closed **Merged:** Yes --- Adds a documentation page for the ArtMCP server, displayed when accessing the MCP endpoint in a browser. Documents all available tools, prompts, and resources. Also adds REST API endpoints to fetch content and updates MCP resources to use these endpoints. ### Changes - **`content/documentation.md`** - Comprehensive markdown documentation covering: - 6 tools (activity, resume-link, stats, status-page, uses-by-category, weather) - 11 prompts with input schemas where applicable - 9 resources with URIs and descriptions - MCP client integration examples and REST API endpoints - **`content.config.ts`** - Added `documentation` collection - **`app/pages/index.vue`** - Replaced hello page with documentation renderer - **New API endpoints in `/server/api/`**: - `profile.get.ts` - Profile information - `contact.get.ts` - Contact information - `skills.get.ts` - Technical skills - `experiences.get.ts` - Work experiences (sorted by startDate descending) - `education.get.ts` - Education background (sorted by startDate descending) - `projects.get.ts` - Projects portfolio - `languages.get.ts` - Spoken languages - `hobbies.get.ts` - Hobbies and interests - `uses.get.ts` - Tech stack and tools organized by category - **Updated MCP resources** - All 9 MCP resources (profile, contact, skills, experiences, education, projects, languages, hobbies, uses) now use `$fetch('/api/{endpoint}')` instead of duplicating the query logic, ensuring consistency between REST API and MCP resources. <!-- START COPILOT CODING AGENT SUFFIX --> <details> <summary>Original prompt</summary> > Write a documentation for my mcp into a markdown page named 'documentation.md' in the content directory. And query it on the main page to provide a documentation when accessing the mcp on the browser. I want it to talk about tools, prompts and resources </details> <!-- START COPILOT CODING AGENT TIPS --> --- 💬 We'd love your input! Share your thoughts on Copilot coding agent in our [2 minute survey](https://gh.io/copilot-coding-agent-survey).
arthur added the pull-request label 2025-12-17 14:22:56 +01:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: arthur/artapi#7