{"id":29360080,"url":"https://github.com/peterbud/nitro-mcp-server","last_synced_at":"2026-05-15T22:39:21.623Z","repository":{"id":302300870,"uuid":"1011887954","full_name":"peterbud/nitro-mcp-server","owner":"peterbud","description":" MCP (Model Context Protocol) server powered by Nitro","archived":false,"fork":false,"pushed_at":"2025-07-01T15:40:23.000Z","size":101,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-01T16:43:40.551Z","etag":null,"topics":["mcp","mcpserver","nitro","streamable-http"],"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/peterbud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2025-07-01T13:37:36.000Z","updated_at":"2025-07-01T15:40:46.000Z","dependencies_parsed_at":"2025-07-01T16:53:52.864Z","dependency_job_id":null,"html_url":"https://github.com/peterbud/nitro-mcp-server","commit_stats":null,"previous_names":["peterbud/nitro-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/peterbud/nitro-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterbud%2Fnitro-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterbud%2Fnitro-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterbud%2Fnitro-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterbud%2Fnitro-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/peterbud","download_url":"https://codeload.github.com/peterbud/nitro-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterbud%2Fnitro-mcp-server/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264411163,"owners_count":23603804,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["mcp","mcpserver","nitro","streamable-http"],"created_at":"2025-07-09T07:09:50.573Z","updated_at":"2026-05-15T22:39:16.586Z","avatar_url":"https://github.com/peterbud.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nitro MCP Server\n\nThis project is an MCP ([Model Context Protocol](https://modelcontextprotocol.io/)) server using **streamable HTTP** transport powered by the [Nitro](https://nitro.build/). It is designed to demonstrate how to implement an MCP Server including authentication using pluggable providers.\n\n## Features\n- Lightweight and fast, built on [Nitro](https://nitro.build/)\n- Tools located at `/tools`\n- Input and output schema validation with [Zod](https://zod.dev/)\n- Example tools included:\n  - `echo`: Echoes back the input, demonstrating basic tool functionality\n  - `getPostsByUser`: Fetches posts by a user using an API, demonstrating output schema validation and `structuredContent`\n- Example resources included:\n  - `posts`: Fetches posts from an API, demonstrating resource handling\n  - `users`: Fetches users from an API, demonstrating resource handling\n- Easy integration with MCP clients\n- Authentication support with pluggable providers (Auth0, Microsoft Entra ID)\n\n## Getting Started\n\n### Prerequisites\n- Node.js (v20 or higher recommended)\n- pnpm (see [pnpm installation guide](https://pnpm.io/installation))\n\n### Installation\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/yourusername/nitro-mcp-server.git\n   cd nitro-mcp-server\n   ```\n2. Install dependencies:\n   ```bash\n   pnpm install\n   ```\n\n### Running the Server\nStart the server with:\n```bash\npnpm dev\n```\n\nRunning the MCP inspector:\n```bash\npnpm inspect\n```\n\n1. Open your browser and navigate to the inspector URL like `http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=\u003ctoken\u003e` to access the MCP inspector.\n2. Enter the address and port of your server at the URL field, like `http://localhost:3000/mcp`.\n3. Click \"Connect\" to establish a connection to your MCP Server.\n4. You can list the tools and invoke them.\n\n### Building the server\n\nTo build the server for production, run:\n```bash\npnpm build\n```\nThis will create a production-ready build in the `.output` directory.\n\n## Configuration\nConfiguration options can be set in the `.env` file. Options include:\n- `NITRO_MCP_SERVER_HOST`: The host the server listens on (default: `localhost`)\n- `NITRO_MCP_SERVER_PORT`: The port the server listens on (default: 3000)\n\n## Authentication\nAuthentication is supported via pluggable providers. Currently, Auth0 and Microsoft Entra ID are available. You can enable authentication by configuring the provider in your server settings or your local `.env` file in development.\n\nAs many Identity Providers do not support Dynamic Client Registration (DCR), this application uses an oAuth proxy solution to provide DCR as MCP specification requires, but delegates all the authentication responsibilities to the Identity Provider. Please note as such apply appropriate rate limiting to prevent misuse of `register` endpoint.\n\n### Supported Providers\n- **Auth0**: Configure with your Auth0 domain, client ID, and client secret.\n- **Entra (Microsoft Entra ID)**: Configure with your tenant ID, client ID, and client secret.\n\nExample configuration:\n```js\nmcpServer: {\n  auth: {\n    providers: {\n      auth0: {\n        type: 'auth0',\n        domain: '\u003cyour-auth0-domain\u003e',\n        clientId: '\u003cyour-client-id\u003e',\n        clientSecret: '\u003cyour-client-secret\u003e',\n        scope: 'openid profile email',\n      },\n      entra: {\n        type: 'entra',\n        tenantId: '\u003cyour-tenant-id\u003e',\n        clientId: '\u003cyour-client-id\u003e',\n        clientSecret: '\u003cyour-client-secret\u003e',\n        scope: 'openid profile email',\n      }\n    }\n  }\n}\n```\n\nThese settings are configurable in an `.env' file or directly in the development environment, and at the server configuration in production. See the [env.example](env.example) file for a template.\n\nSee the provider files in `lib/auth/` for more details and advanced options.\n\n## Todo\n\n- Add cleanup task for expired authorization codes\n\n## Contributing\nPull requests and issues are welcome! Please open an issue to discuss your ideas or report bugs.\n\n## License\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeterbud%2Fnitro-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpeterbud%2Fnitro-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeterbud%2Fnitro-mcp-server/lists"}