{"id":28166513,"url":"https://github.com/instructa/mcp-starter","last_synced_at":"2025-06-27T10:06:50.912Z","repository":{"id":288274956,"uuid":"967450974","full_name":"instructa/mcp-starter","owner":"instructa","description":"A super simple Starter to build your own MCP Server","archived":false,"fork":false,"pushed_at":"2025-05-11T07:58:50.000Z","size":1352,"stargazers_count":19,"open_issues_count":2,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-16T11:46:47.884Z","etag":null,"topics":["ai","mcp","mcp-start","model-context-protocol","mpc-blueprint","server-starter"],"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/instructa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-04-16T13:26:28.000Z","updated_at":"2025-06-10T12:55:22.000Z","dependencies_parsed_at":"2025-04-21T18:23:28.769Z","dependency_job_id":null,"html_url":"https://github.com/instructa/mcp-starter","commit_stats":null,"previous_names":["instructa/mcp-starter","dx-zero/mcp-starter"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/instructa/mcp-starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instructa%2Fmcp-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instructa%2Fmcp-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instructa%2Fmcp-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instructa%2Fmcp-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/instructa","download_url":"https://codeload.github.com/instructa/mcp-starter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instructa%2Fmcp-starter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262235786,"owners_count":23279566,"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":["ai","mcp","mcp-start","model-context-protocol","mpc-blueprint","server-starter"],"created_at":"2025-05-15T13:13:03.077Z","updated_at":"2025-06-27T10:06:50.852Z","avatar_url":"https://github.com/instructa.png","language":"TypeScript","readme":"# MCP Server Starter\n\n![mcp starter](/public/banner.png)\n\n\u003cdiv align=\"center\"\u003e\n  \u003c!-- \u003cimg alt=\"NPM Downloads\" src=\"https://img.shields.io/npm/instructa/mcpn?style=flat-square\u0026logo=npm\"\u003e\n  \u003cimg alt=\"jsDelivr hits (npm)\" src=\"https://img.shields.io/jsdelivr/npm/instructa/mcpn?style=flat-square\u0026logo=jsdeliver\"\u003e\n  \u003cimg alt=\"GitHub Sponsors\" src=\"https://img.shields.io/github/sponsors/instructa/mcpn?style=flat-square\u0026logo=github\"\u003e\n  \u003cbr /\u003e --\u003e\n  \u003cstrong\u003eCreated by\u003c/strong\u003e\u003cbr /\u003e\n  \u003ca href=\"https://twitter.com/kregenrek\"\u003e\n    \u003cimg src=\"https://img.shields.io/twitter/follow/kregenrek?style=social\" alt=\"Follow @kregenrek on Twitter\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n**Want to build your own MCP server?**\n\nMCP Server Starter gives you a basic structure to run local tools with Cursor, Claude, and others using the MCP standard.\n\n---\n\n\u003ca href=\"https://glama.ai/mcp/servers/@instructa/mcp-starter\"\u003e\n  \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@instructa/mcp-starter/badge\" alt=\"Starter MCP server\" /\u003e\n\u003c/a\u003e\n\n## Features\n\n- 📡 **Flexible Communication**\n  - Supports multiple communication protocols between client and server,\n  - `stdio`: Local usage\n  - `Streamable HTTP`: Remote and local useage\n  - `sse`: Remote and local usage (deprecated)~~\n\n- 📦 **Minimal Setup** - Get started quickly with a basic server implementation.\n- 🤖 **Cursor AI Integration** - Includes example `.cursor/mcp.json` configuration.\n- ⌨️ **TypeScript** - Add type safety to your project.\n\n## Todo\n\n- [ ] Add option to publish your own packages\n- [ ] Better CLI support for scaffolding\n- [ ] Prompts to build tools on the fly\n\n## Getting Started\n\n### Prerequisites\n\n- [Node.js](https://nodejs.org/) (Specify version if necessary)\n- An MCP-compatible client (e.g., [Cursor](https://cursor.com/))\n\n## Usage\n\n### Supported Transport Options\n\nModel Context Protocol Supports multiple Transport methods.\n\n### stdio\n\n![mcp starter](/public/stdio-mcp-starter.jpg)\n\nRecommend for local setups\n\n#### Code Editor Support\n\nAdd the code snippets below\n\n* Cursor: `.cursor/mcp.json`\n\n**Local development/testing**\n\nUse this if you want to test your mcp server locally\n\n```json\n{\n  \"mcpServers\": {\n    \"my-starter-mcp-stdio\": {\n      \"command\": \"node\",\n      \"args\": [\"./bin/cli.mjs\", \"--stdio\"]\n    }\n  }\n}\n```\n\n**Published Package**\n\nUse this when you have published your package in the npm registry\n\n```json\n{\n  \"mcpServers\": {\n    \"my-starter-mcp-stdio\": {\n      \"command\": \"npx\",\n      \"args\": [\"my-mcp-server\", \"--stdio\"]\n    }\n  }\n}\n```\n\n### Streamable HTTP\n\n![mcp starter](/public/mcp-sse-starter.jpg)\n\n\u003eImportant: Streamable HTTP is not supported in Cursor yet\n\nRecommend for remote server usage\n\n**Important:** In contrast to stdio you need also to run the server with the correct flag\n\n**Local development**\nUse the `streamable http` transport\n\n1. Start the MCP Server\n  Run this in your terminal\n  ```bash\n  node ./bin/cli.mjs --http --port 4200\n  ```\n\n  Or with mcp inspector\n  ```\n  npm run dev-http\n  # npm run dev-sse (deprecated)\n  ```\n\n  2. Add this to your config\n  ```json\n  {\n    \"mcpServers\": {\n      \"my-starter-mcp-http\": {\n        \"command\": \"node\",\n        \"args\": [\"./bin/cli.mjs\", \"--http\", \"--port\", \"4001\"]\n        // \"args\": [\"./bin/cli.mjs\", \"--sse\", \"--port\", \"4002\"] (or deprecated sse usage)\n      }\n    }\n  }\n  ```\n\n**Published Package**\n\nUse this when you have published your package in the npm registry\n\nRun this in your terminal\n```bash\nnpx my-mcp-server --http --port 4200\n# npx my-mcp-server --sse --port 4201 (deprecated)\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"my-starter-mcp-http\": {\n      \"url\": \"http://localhost:4200/mcp\"\n      // \"url\": \"http://localhost:4201/sse\"\n    }\n  }\n}\n```\n\n## Use the Inspector\n\nUse the `inspect` command to debug your mcp server\n\n![mcp starter](/public/inspect.jpg)\n![mcp starter](/public/streamable2.jpg)\n\n## Command-Line Options\n\n### Protocol Selection\n\n| Protocol | Description            | Flags                                                | Notes           |\n| :------- | :--------------------- | :--------------------------------------------------- | :-------------- |\n| `stdio`  | Standard I/O           | (None)                                               | Default         |\n| `http`   | HTTP REST              | `--port \u003cnum\u003e` (def: 3000), `--endpoint \u003cpath\u003e` (def: `/mcp`) |                 |\n| `sse`    | Server-Sent Events     | `--port \u003cnum\u003e` (def: 3000)                            | Deprecated      |\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n---\n\n## Courses\n- Learn to build software with AI: [instructa.ai](https://www.instructa.ai)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finstructa%2Fmcp-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finstructa%2Fmcp-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finstructa%2Fmcp-starter/lists"}