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

Closed
opened 2025-12-01 17:04:18 +01:00 by arthur · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/ArthurDanjou/artmcp/pull/5
Author: @Copilot
Created: 11/30/2025
Status: Merged
Merged: 11/30/2025
Merged by: @ArthurDanjou

Base: masterHead: copilot/add-documentation-for-mcp


📝 Commits (4)

  • 8806ed4 Initial plan
  • a99438f Initial progress report with plan
  • 377cab7 Add MCP documentation page with tools, prompts and resources
  • f6ab805 Add API endpoints for content and update MCP resources to use them

📊 Changes

22 files changed (+19124 additions, -110 deletions)

View changed files

📝 app/pages/index.vue (+116 -30)
📝 content.config.ts (+4 -0)
content/documentation.md (+164 -0)
package-lock.json (+18731 -0)
server/api/contact.get.ts (+7 -0)
server/api/education.get.ts (+15 -0)
server/api/experiences.get.ts (+17 -0)
server/api/hobbies.get.ts (+7 -0)
server/api/languages.get.ts (+7 -0)
server/api/profile.get.ts (+7 -0)
server/api/projects.get.ts (+7 -0)
server/api/skills.get.ts (+7 -0)
server/api/uses.get.ts (+19 -0)
📝 server/mcp/resources/contact.ts (+2 -6)
📝 server/mcp/resources/education.ts (+1 -13)
📝 server/mcp/resources/experiences.ts (+1 -15)
📝 server/mcp/resources/hobbies.ts (+2 -6)
📝 server/mcp/resources/languages.ts (+2 -6)
📝 server/mcp/resources/profile.ts (+1 -5)
📝 server/mcp/resources/projects.ts (+1 -5)

...and 2 more files

📄 Description

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.


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/ArthurDanjou/artmcp/pull/5 **Author:** [@Copilot](https://github.com/apps/copilot-swe-agent) **Created:** 11/30/2025 **Status:** ✅ Merged **Merged:** 11/30/2025 **Merged by:** [@ArthurDanjou](https://github.com/ArthurDanjou) **Base:** `master` ← **Head:** `copilot/add-documentation-for-mcp` --- ### 📝 Commits (4) - [`8806ed4`](https://github.com/ArthurDanjou/artmcp/commit/8806ed40d53022db636a832fba1e23ed5446effa) Initial plan - [`a99438f`](https://github.com/ArthurDanjou/artmcp/commit/a99438f93fa9318e58e5fd79b663f388c9dd56ac) Initial progress report with plan - [`377cab7`](https://github.com/ArthurDanjou/artmcp/commit/377cab77ed9d6ca26f626f62df10e7f39cc17fb4) Add MCP documentation page with tools, prompts and resources - [`f6ab805`](https://github.com/ArthurDanjou/artmcp/commit/f6ab805ef3694cf93b623d7a0bf2e1af97d302e8) Add API endpoints for content and update MCP resources to use them ### 📊 Changes **22 files changed** (+19124 additions, -110 deletions) <details> <summary>View changed files</summary> 📝 `app/pages/index.vue` (+116 -30) 📝 `content.config.ts` (+4 -0) ➕ `content/documentation.md` (+164 -0) ➕ `package-lock.json` (+18731 -0) ➕ `server/api/contact.get.ts` (+7 -0) ➕ `server/api/education.get.ts` (+15 -0) ➕ `server/api/experiences.get.ts` (+17 -0) ➕ `server/api/hobbies.get.ts` (+7 -0) ➕ `server/api/languages.get.ts` (+7 -0) ➕ `server/api/profile.get.ts` (+7 -0) ➕ `server/api/projects.get.ts` (+7 -0) ➕ `server/api/skills.get.ts` (+7 -0) ➕ `server/api/uses.get.ts` (+19 -0) 📝 `server/mcp/resources/contact.ts` (+2 -6) 📝 `server/mcp/resources/education.ts` (+1 -13) 📝 `server/mcp/resources/experiences.ts` (+1 -15) 📝 `server/mcp/resources/hobbies.ts` (+2 -6) 📝 `server/mcp/resources/languages.ts` (+2 -6) 📝 `server/mcp/resources/profile.ts` (+1 -5) 📝 `server/mcp/resources/projects.ts` (+1 -5) _...and 2 more files_ </details> ### 📄 Description 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). --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
arthur added the pull-request label 2025-12-01 17:04:18 +01:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: arthur/artmcp#10