{"id":27004150,"url":"https://github.com/cephalization/mcp-ts-quickstart","last_synced_at":"2026-04-18T01:03:02.204Z","repository":{"id":286011285,"uuid":"960066263","full_name":"cephalization/mcp-ts-quickstart","owner":"cephalization","description":"Build-less TypeScript quickstart for an MCP server implementation","archived":false,"fork":false,"pushed_at":"2025-04-03T20:16:14.000Z","size":489,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-09T17:07:23.424Z","etag":null,"topics":["build-free","mcp","mcp-server","node","typescript"],"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/cephalization.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}},"created_at":"2025-04-03T20:00:52.000Z","updated_at":"2025-04-03T20:16:17.000Z","dependencies_parsed_at":"2025-04-03T21:33:36.481Z","dependency_job_id":null,"html_url":"https://github.com/cephalization/mcp-ts-quickstart","commit_stats":null,"previous_names":["cephalization/mcp-ts-quickstart"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cephalization/mcp-ts-quickstart","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cephalization%2Fmcp-ts-quickstart","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cephalization%2Fmcp-ts-quickstart/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cephalization%2Fmcp-ts-quickstart/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cephalization%2Fmcp-ts-quickstart/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cephalization","download_url":"https://codeload.github.com/cephalization/mcp-ts-quickstart/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cephalization%2Fmcp-ts-quickstart/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272475085,"owners_count":24940683,"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","status":"online","status_checked_at":"2025-08-28T02:00:10.768Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["build-free","mcp","mcp-server","node","typescript"],"created_at":"2025-04-04T06:15:11.239Z","updated_at":"2026-04-18T01:02:57.182Z","avatar_url":"https://github.com/cephalization.png","language":"TypeScript","funding_links":[],"categories":["🌐 Web Development"],"sub_categories":[],"readme":"# MCP TS Quickstart\n\nThis is a quickstart for MCP in TypeScript.\n\nIt includes a basic MCP server implementation that uses the `stdio` transport,\nand fetches the top stories from Hacker News.\n\nIt is written in TypeScript and works without a build step by utilizing Node v23.\n\nBased on the example provided in the [MCP documentation](https://modelcontextprotocol.io/quickstart/server).\n\n![preview](./assets/preview.png)\n\n## Usage\n\nThe snippet below requires `git`, `nvm`, and `pnpm`.\n\n```bash\ngit clone git@github.com:cephalization/mcp-ts-quickstart.git\ncd mcp-ts-quickstart\nnvm install \u0026\u0026 nvm use\npnpm install\n```\n\nOnce cloned and dependencies installed, you can add this server to Claude Desktop with a config similar to the following:\n\n```json\n{\n  \"mcpServers\": {\n    \"hacker-news\": {\n      \"command\": \"/Users/tony/.nvm/versions/node/v23.6.0/bin/node\",\n      \"args\": [\"/Users/tony/repos/mcp/src/index.ts\"]\n    }\n  }\n}\n```\n\nSee the [MCP documentation](https://modelcontextprotocol.io/quickstart/user) for more information on how to use Claude Desktop as a client.\n\n## Development\n\nThe following commands will install the dependencies, and then start the MCP server with the [MCP Inspector](https://github.com/modelcontextprotocol/inspector) UI as a client.\n\n```bash\nnvm install \u0026\u0026 nvm use\npnpm install\npnpm start\n```\n\nBecause the server is build-less, you can simply \"restart\" the server inside of the inspector UI by pressing the \"Restart\" button.\n\n## Extending the server\n\nThe server is implemented in `src/index.ts`.\n\nThe `topStories` tool is implemented in `src/tools.ts`.\n\nTo add a new tool, you can copy the `topStories` tool and modify it.\n\nWhen importing local src files, make sure to use the `.ts` extension so that node can resolve it.\n\nWhen importing types, make sure to add the `type` keyword in front of the import so that node can strip it out at runtime.\n\nWhen importing libraries, make sure to import the actual source file extension, if it does not provide an exports mapping.\n\n## MCP Inspector\n\nThe MCP Inspector is a UI for interacting with MCP servers.\n\nWhen run, it will be available at [http://localhost:6274](http://localhost:6274).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcephalization%2Fmcp-ts-quickstart","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcephalization%2Fmcp-ts-quickstart","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcephalization%2Fmcp-ts-quickstart/lists"}