diff --git a/README.md b/README.md index f14096a0..107c7904 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ A community-created collection of custom agents, instructions, skills, hooks, wo > [!TIP] > **Explore the full collection on the website →** [awesome-copilot.github.com](https://awesome-copilot.github.com) > -> The website offers full-text search and filtering across hundreds of resources, plus the [Tools](https://awesome-copilot.github.com/tools) section for MCP servers and developer tooling, and the [Learning Hub](https://awesome-copilot.github.com/learning-hub) for guides and tutorials. +> The website offers full-text search and filtering across hundreds of resources, plus the [Learning Hub](https://awesome-copilot.github.com/learning-hub) for guides and tutorials. > > **Using this collection in an AI agent?** A machine-readable [`llms.txt`](https://awesome-copilot.github.com/llms.txt) is available with structured listings of all agents, instructions, and skills. diff --git a/eng/generate-website-data.mjs b/eng/generate-website-data.mjs index 1f3659da..3abfb54e 100755 --- a/eng/generate-website-data.mjs +++ b/eng/generate-website-data.mjs @@ -618,8 +618,11 @@ function generatePluginsData(gitDates, resourceIndex = {}) { const mcpItems = []; if (data.mcpServers) { let mcpServersObj = null; + let mcpConfigPath = relPath; if (typeof data.mcpServers === "string") { - const mcpJsonPath = path.join(pluginDir, data.mcpServers.replace(/^\.\//, "")); + const manifestMcpPath = data.mcpServers.replace(/^\.\//, ""); + mcpConfigPath = manifestMcpPath ? `${relPath}/${manifestMcpPath}` : relPath; + const mcpJsonPath = path.join(pluginDir, manifestMcpPath); if (fs.existsSync(mcpJsonPath)) { try { const mcpJson = JSON.parse(fs.readFileSync(mcpJsonPath, "utf-8")); @@ -633,7 +636,7 @@ function generatePluginsData(gitDates, resourceIndex = {}) { } if (mcpServersObj) { for (const serverName of Object.keys(mcpServersObj)) { - mcpItems.push({ kind: "mcp", path: serverName, title: serverName }); + mcpItems.push({ kind: "mcp", path: mcpConfigPath, title: serverName }); } } } diff --git a/plugins/awesome-copilot/README.md b/plugins/awesome-copilot/README.md index 421e98f1..ba563382 100644 --- a/plugins/awesome-copilot/README.md +++ b/plugins/awesome-copilot/README.md @@ -9,6 +9,11 @@ Meta prompts that help you discover and generate curated GitHub Copilot agents, copilot plugin install awesome-copilot@awesome-copilot ``` +## Prerequisites + +- [Docker](https://www.docker.com/) must be installed and available on your `PATH`. +- The plugin starts its bundled MCP server by running `docker run ... ghcr.io/microsoft/mcp-dotnet-samples/awesome-copilot:latest`. + ## What's Included ### Commands (Slash Commands) @@ -26,6 +31,10 @@ copilot plugin install awesome-copilot@awesome-copilot |-------|-------------| | `meta-agentic-project-scaffold` | Meta agentic project creation assistant to help users create and manage project workflows effectively. | +### MCP server + +This plugin includes the `awesome-copilot` MCP server configured in [`./.mcp.json`](./.mcp.json). If Docker is unavailable, MCP startup will fail. + ## Source This plugin is part of [Awesome Copilot](https://github.com/github/awesome-copilot), a community-driven collection of GitHub Copilot extensions. diff --git a/website/src/content/docs/learning-hub/agentic-workflows.md b/website/src/content/docs/learning-hub/agentic-workflows.md index 7b876aec..9887f1e5 100644 --- a/website/src/content/docs/learning-hub/agentic-workflows.md +++ b/website/src/content/docs/learning-hub/agentic-workflows.md @@ -77,7 +77,7 @@ Agentic Workflows are ideal when you need **autonomous, event-driven automation* ## Using Workflows from Awesome Copilot -The [Awesome Copilot workflows page](../../workflows/) hosts a growing collection of community-contributed workflows. Here's how to install and use them. +The [repository workflows directory](https://github.com/github/awesome-copilot/tree/main/workflows) hosts a growing collection of community-contributed workflows. Here's how to install and use them. ### Prerequisites @@ -89,7 +89,7 @@ gh extension install github/gh-aw ### Installing a Workflow -1. **Browse** the [workflows collection](../../workflows/) and find one that fits your needs +1. **Browse** the [workflows collection](https://github.com/github/awesome-copilot/tree/main/workflows) and find one that fits your needs 2. **Copy** the workflow `.md` file into your repository's `.github/workflows/` directory 3. **Compile** the workflow to generate the Actions lock file: diff --git a/website/src/content/docs/learning-hub/using-copilot-coding-agent.md b/website/src/content/docs/learning-hub/using-copilot-coding-agent.md index b0e8a8c8..4ff5a344 100644 --- a/website/src/content/docs/learning-hub/using-copilot-coding-agent.md +++ b/website/src/content/docs/learning-hub/using-copilot-coding-agent.md @@ -327,7 +327,7 @@ This repository provides a curated collection of agents, skills, and hooks desig ### Adding Hooks from This Repo -1. Browse the [Hooks Directory](../../hooks/) for automation hooks +1. Browse the [Hooks documentation](https://github.com/github/awesome-copilot/blob/main/docs/README.hooks.md) for automation hooks 2. Copy the `hooks.json` content into a file in `.github/hooks/` in your repository 3. Copy any referenced scripts alongside it 4. The hooks will run automatically during coding agent sessions