{"id":32592464,"url":"https://github.com/7nohe/adonis-mcp","last_synced_at":"2026-03-17T20:12:09.880Z","repository":{"id":285918273,"uuid":"957476775","full_name":"7nohe/adonis-mcp","owner":"7nohe","description":"An AdonisJS package for building remote MCP servers","archived":false,"fork":false,"pushed_at":"2025-07-21T13:49:11.000Z","size":25,"stargazers_count":9,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-13T03:50:05.093Z","etag":null,"topics":["adonisjs","mcp-server","modelcontextprotocol"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/7nohe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-30T13:25:30.000Z","updated_at":"2025-10-29T23:08:50.000Z","dependencies_parsed_at":"2025-04-03T10:51:54.869Z","dependency_job_id":"422ae1b8-5ad2-4bc5-94a0-b1213af135a2","html_url":"https://github.com/7nohe/adonis-mcp","commit_stats":null,"previous_names":["7nohe/adonis-mcp"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/7nohe/adonis-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/7nohe%2Fadonis-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/7nohe%2Fadonis-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/7nohe%2Fadonis-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/7nohe%2Fadonis-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/7nohe","download_url":"https://codeload.github.com/7nohe/adonis-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/7nohe%2Fadonis-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30630261,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-17T17:32:55.572Z","status":"ssl_error","status_checked_at":"2026-03-17T17:32:38.732Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adonisjs","mcp-server","modelcontextprotocol"],"created_at":"2025-10-30T02:01:53.503Z","updated_at":"2026-03-17T20:12:09.872Z","avatar_url":"https://github.com/7nohe.png","language":"TypeScript","funding_links":[],"categories":["🌐 Web Development"],"sub_categories":[],"readme":"# Adonis MCP\n\nAdonis MCP is a package designed for the AdonisJS framework that provides support for the Model Context Protocol (MCP). With this package, you can easily build remote MCP servers using Server-Sent Events (SSE).\n\n## Installation\n\nRun the following command to install the package:\n\n```bash\nnode ace add @7nohe/adonis-mcp\n```\n\n## Configuration\n\nAfter installation, a `config/mcp.ts` file will be generated. Edit this file to customize the MCP server settings.\n\nExample:\n\n```ts\nimport { defineConfig } from '@7nohe/adonis-mcp'\n\nexport default defineConfig({\n  ssePath: '/sse',\n  messagesPath: '/messages',\n  serverOptions: {\n    name: 'mymcp',\n    version: '0.0.1',\n  },\n})\n```\n\n## Usage\n\n### Registering Routes\n\nYou can use the `registerRoutes` method in `start/routes.ts` to define tools and prompts. Below is an example:\n\n```ts\nimport mcp from '@7nohe/adonis-mcp/services/main'\nimport { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport { z } from 'zod'\n\nawait mcp.registerRoutes((server) =\u003e {\n  server.resource(\n    'echo',\n    new ResourceTemplate('echo://{message}', { list: undefined }),\n    async (uri, { message }) =\u003e ({\n      contents: [\n        {\n          uri: uri.href,\n          text: `Resource echo: ${message}`,\n        },\n      ],\n    })\n  )\n\n  server.tool('echo', { message: z.string() }, async ({ message }) =\u003e ({\n    content: [{ type: 'text', text: `Tool echo: ${message}` }],\n  }))\n\n  server.prompt('echo', { message: z.string() }, ({ message }) =\u003e ({\n    messages: [\n      {\n        role: 'user',\n        content: {\n          type: 'text',\n          text: `Please process this message: ${message}`,\n        },\n      },\n    ],\n  }))\n})\n```\n\n### Starting the Server\n\nAfter defining the routes, start the MCP server by running the following command:\n\n```bash\nnpm run dev\n```\n\n## Debugging\n\n### Using Configuration File\n\nTo debug, edit the MCP server configuration file (e.g., for Claude Desktop or Cursor) as follows:\n\n```json\n{\n  \"mcpServers\": {\n    \"mymcp\": {\n      \"url\": \"http://localhost:3333/sse\"\n    }\n  }\n}\n```\n\n### Using Inspector\n\nAnother debugging method is to use the Inspector. Start it with the following command:\n\n```bash\nnpx @modelcontextprotocol/inspector\n```\n\n1. Set the Transport Type to `SSE`.\n2. Enter the URL `http://localhost:3333/sse`.\n3. Click the `Connect` button.\n4. Confirm that the status changes to `Connected`.\n\nFor more details, refer to the [Inspector Documentation](https://modelcontextprotocol.io/docs/tools/inspector).\n\n## License\n\nThis project is provided under the [MIT License](./LICENSE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F7nohe%2Fadonis-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F7nohe%2Fadonis-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F7nohe%2Fadonis-mcp/lists"}