{"_id":"@slinerodev/github-releases-mcp","_rev":"4-e4811e79b702464241f0aaccee022e16","name":"@slinerodev/github-releases-mcp","dist-tags":{"latest":"0.2.0"},"versions":{"0.0.1":{"name":"@slinerodev/github-releases-mcp","version":"0.0.1","keywords":["mcp","github","releases","modelcontextprotocol"],"author":{"name":"Sergio Linero"},"license":"ISC","_id":"@slinerodev/github-releases-mcp@0.0.1","maintainers":[{"name":"slinerodev","email":"slinerodev@gmail.com"}],"homepage":"https://github.com/slinerodev/github-releases-mcp#readme","bugs":{"url":"https://github.com/slinerodev/github-releases-mcp/issues"},"bin":{"github-releases-mcp":"dist/main.js"},"dist":{"shasum":"5929920ad7b5e05e285515c4e02bf7af01848959","tarball":"https://registry.npmjs.org/@slinerodev/github-releases-mcp/-/github-releases-mcp-0.0.1.tgz","fileCount":4,"integrity":"sha512-cDcsfSeCZIwlRT+aP89JTJ1EtkqoO8DBAKmyd2gaqRB479fPP8INoJwb48cMSaiblXW7Vdnik+dkclgf9PRf4w==","signatures":[{"sig":"MEYCIQCwFQFCPctGYL3tMA883hcwon0mmC0CByrbg+Fug+ohVAIhAIlRRYqUXdQRRw6BwkPlMGGhSta8Yu3qr+CSXhA0WxlP","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8151},"main":"dist/main.js","type":"module","types":"dist/main.d.ts","gitHead":"284fb149abc95633705ff697a7f0b3d597e84bfe","scripts":{"dev":"tsx watch main.ts","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","start":"tsx main.ts","prepublishOnly":"npm run build"},"_npmUser":{"name":"slinerodev","email":"slinerodev@gmail.com"},"repository":{"url":"git+https://github.com/slinerodev/github-releases-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"A Model Context Protocol (MCP) tool that fetches and displays GitHub repository releases in a formatted way","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.24.3","@modelcontextprotocol/sdk":"^1.10.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@10.6.3+sha512.bb45e34d50a9a76e858a95837301bfb6bd6d35aea2c5d52094fa497a467c43f5c440103ce2511e9e0a2f89c3d6071baac3358fc68ac6fb75e2ceb3d2736065e6","devDependencies":{"tsx":"^4.7.1","typescript":"^5.4.2","@types/node":"^22.15.2"},"_npmOperationalInternal":{"tmp":"tmp/github-releases-mcp_0.0.1_1745674728601_0.26344314069801267","host":"s3://npm-registry-packages-npm-production"}},"0.0.2":{"name":"@slinerodev/github-releases-mcp","version":"0.0.2","keywords":["mcp","github","releases","modelcontextprotocol"],"author":{"name":"Sergio Linero"},"license":"ISC","_id":"@slinerodev/github-releases-mcp@0.0.2","maintainers":[{"name":"slinerodev","email":"slinerodev@gmail.com"}],"homepage":"https://github.com/slinerodev/github-releases-mcp#readme","bugs":{"url":"https://github.com/slinerodev/github-releases-mcp/issues"},"bin":{"github-releases-mcp":"dist/main.js"},"dist":{"shasum":"d2a3c4769efc945ddc03988e661282dcdfcb73cf","tarball":"https://registry.npmjs.org/@slinerodev/github-releases-mcp/-/github-releases-mcp-0.0.2.tgz","fileCount":4,"integrity":"sha512-yuImxmXSQDUK3N7A1L9kBLVkhymw6F6tZngpDuHcYScZtMH6L/K7cmIdDPHN1wdMaVLhQWWAjIx8CmNyMwa5yA==","signatures":[{"sig":"MEUCIQDOC0tbPtJLTRRZIRhgFdd3L+WnwCKb42iPst+j9ox5ngIgFiy+fFsOA5eNJAw2xN0ePGHmqY0NSREofYqrvIlj264=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8159},"main":"dist/main.js","type":"module","types":"dist/main.d.ts","gitHead":"d6091990aba45ac9e3da1b1d85e5b6bafbccb3e0","scripts":{"dev":"tsx watch src/main.ts","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","start":"tsx src/main.ts","prepublishOnly":"npm run build"},"_npmUser":{"name":"slinerodev","email":"slinerodev@gmail.com"},"repository":{"url":"git+https://github.com/slinerodev/github-releases-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"A Model Context Protocol (MCP) tool that fetches and displays GitHub repository releases in a formatted way","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.24.3","@modelcontextprotocol/sdk":"^1.10.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@10.6.3+sha512.bb45e34d50a9a76e858a95837301bfb6bd6d35aea2c5d52094fa497a467c43f5c440103ce2511e9e0a2f89c3d6071baac3358fc68ac6fb75e2ceb3d2736065e6","devDependencies":{"tsx":"^4.7.1","typescript":"^5.4.2","@types/node":"^22.15.2"},"_npmOperationalInternal":{"tmp":"tmp/github-releases-mcp_0.0.2_1745675131705_0.794243448081609","host":"s3://npm-registry-packages-npm-production"}},"0.1.0":{"name":"@slinerodev/github-releases-mcp","version":"0.1.0","keywords":["mcp","github","releases","modelcontextprotocol","changelog","version-comparison","release-management","semantic-versioning"],"author":{"name":"Sergio Linero"},"license":"ISC","_id":"@slinerodev/github-releases-mcp@0.1.0","maintainers":[{"name":"slinerodev","email":"slinerodev@gmail.com"}],"homepage":"https://github.com/slinerodev/github-releases-mcp#readme","bugs":{"url":"https://github.com/slinerodev/github-releases-mcp/issues"},"bin":{"github-releases-mcp":"dist/main.js"},"dist":{"shasum":"4df7b019159aa9d33f62439c2e5398f66e5a5dfd","tarball":"https://registry.npmjs.org/@slinerodev/github-releases-mcp/-/github-releases-mcp-0.1.0.tgz","fileCount":8,"integrity":"sha512-fkdtAJI5uUe2ssnjB3uvbxOQsvy0x1j+hVcCLtVsMB1VbuaWBy27sWHNDTinDAzQy++0wAGrnD2/I2huQLgSVw==","signatures":[{"sig":"MEYCIQDvq9uqremAABT3kAZwhAiIvEQTH2QSJ1YIabjltjxrfQIhAM23m6Y7X0k7tyY45cpK9Na2InPBopUI7UnCWz4h+c2b","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19900},"main":"dist/main.js","type":"module","types":"dist/main.d.ts","gitHead":"b8e4f18faff50c48d317da5ae5cdf3d754433419","scripts":{"dev":"tsx watch src/main.ts","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","start":"tsx src/main.ts","prepublishOnly":"npm run build"},"_npmUser":{"name":"slinerodev","email":"slinerodev@gmail.com"},"repository":{"url":"git+https://github.com/slinerodev/github-releases-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"A Model Context Protocol (MCP) toolkit for GitHub releases management. Features include detailed release information, version comparison, and release listing with rich formatting. Perfect for changelog generation, version tracking, and release documentati","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.24.3","semver":"^7.7.1","@types/semver":"^7.7.0","@modelcontextprotocol/sdk":"^1.10.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@10.6.3+sha512.bb45e34d50a9a76e858a95837301bfb6bd6d35aea2c5d52094fa497a467c43f5c440103ce2511e9e0a2f89c3d6071baac3358fc68ac6fb75e2ceb3d2736065e6","devDependencies":{"tsx":"^4.7.1","typescript":"^5.4.2","@types/node":"^22.15.2"},"_npmOperationalInternal":{"tmp":"tmp/github-releases-mcp_0.1.0_1745683524598_0.43314955874174577","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@slinerodev/github-releases-mcp","version":"0.2.0","description":"A Model Context Protocol (MCP) toolkit for GitHub releases management. Features include detailed release information, version comparison, and release listing with rich formatting. Perfect for changelog generation, version tracking, and release documentati","main":"dist/main.js","types":"dist/main.d.ts","type":"module","bin":{"github-releases-mcp":"dist/main.js"},"scripts":{"build":"tsc","dev":"tsx watch src/main.ts","start":"tsx src/main.ts","prepublishOnly":"npm run build","test":"echo \"Error: no test specified\" && exit 1"},"keywords":["mcp","github","releases","modelcontextprotocol","changelog","version-comparison","release-management","semantic-versioning"],"author":{"name":"Sergio Linero"},"license":"ISC","packageManager":"pnpm@10.6.3+sha512.bb45e34d50a9a76e858a95837301bfb6bd6d35aea2c5d52094fa497a467c43f5c440103ce2511e9e0a2f89c3d6071baac3358fc68ac6fb75e2ceb3d2736065e6","dependencies":{"@modelcontextprotocol/sdk":"^1.10.2","@types/semver":"^7.7.0","semver":"^7.7.1","zod":"^3.24.3"},"devDependencies":{"@types/node":"^22.15.2","tsx":"^4.7.1","typescript":"^5.4.2"},"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/slinerodev/github-releases-mcp.git"},"bugs":{"url":"https://github.com/slinerodev/github-releases-mcp/issues"},"homepage":"https://github.com/slinerodev/github-releases-mcp#readme","_id":"@slinerodev/github-releases-mcp@0.2.0","gitHead":"6e4b21bbedea25021d5bc3205aab4483eef1fb4d","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-BB3e+RV0XuabiX3u0/KUHsQ8tnTTUdrXlpMHSouoiEHhvDbUAz3oxkAf7eXOdDf4tJorTDDPoFMx5uXHbfOyMQ==","shasum":"14cc6ae19e9c8902557740075a890574e020da07","tarball":"https://registry.npmjs.org/@slinerodev/github-releases-mcp/-/github-releases-mcp-0.2.0.tgz","fileCount":8,"unpackedSize":27956,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDPSPPQVv69GhPvtLyCdMhw6FLI9c8ymbcqPgRU4T8JaAIgJIXrWt18S8glYAVn/jdVdPcgdQvU/ZrfcT7vH0EDtrI="}]},"_npmUser":{"name":"slinerodev","email":"slinerodev@gmail.com"},"directories":{},"maintainers":[{"name":"slinerodev","email":"slinerodev@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/github-releases-mcp_0.2.0_1745687541853_0.6583217567446282"},"_hasShrinkwrap":false}},"time":{"created":"2025-04-26T13:38:48.513Z","modified":"2025-04-26T17:12:22.246Z","0.0.1":"2025-04-26T13:38:48.778Z","0.0.2":"2025-04-26T13:45:31.871Z","0.1.0":"2025-04-26T16:05:24.783Z","0.2.0":"2025-04-26T17:12:22.045Z"},"bugs":{"url":"https://github.com/slinerodev/github-releases-mcp/issues"},"author":{"name":"Sergio Linero"},"license":"ISC","homepage":"https://github.com/slinerodev/github-releases-mcp#readme","keywords":["mcp","github","releases","modelcontextprotocol","changelog","version-comparison","release-management","semantic-versioning"],"repository":{"type":"git","url":"git+https://github.com/slinerodev/github-releases-mcp.git"},"description":"A Model Context Protocol (MCP) toolkit for GitHub releases management. Features include detailed release information, version comparison, and release listing with rich formatting. Perfect for changelog generation, version tracking, and release documentati","maintainers":[{"name":"slinerodev","email":"slinerodev@gmail.com"}],"readme":"# GitHub Releases MCP Server\r\n\r\nA powerful Model Context Protocol (MCP) toolkit for GitHub releases management. This server provides comprehensive tools for accessing, comparing, and analyzing GitHub repository releases with rich formatting and detailed information.\r\n\r\n## Features\r\n\r\n- 🔍 **Detailed Release Information**: Get comprehensive details about specific releases\r\n- 📊 **Version Comparison**: Compare changes between any two versions\r\n- 📋 **Release Listing**: Get formatted lists of releases with filtering options\r\n- 🏷️ **Semantic Version Support**: Handles various version formats (v1.0.0, @1.0.0, 1.0.0)\r\n- 🎯 **Pre-release Filtering**: Option to include or exclude pre-releases\r\n- 📝 **Rich Formatting**: Emoji-enhanced output for better readability\r\n- 🔄 **Pagination Support**: Handles repositories with many releases\r\n- 🔒 **Authentication**: Optional GitHub token support for private repositories and extended rate limit\r\n\r\n## Configuration\r\n\r\nThe server accepts the following optional environment variables:\r\n\r\n- `GITHUB_PERSONAL_ACCESS_TOKEN`: GitHub Personal Access Token (optional). If provided, it will be used to authenticate API requests, allowing for higher rate limits and access to private repositories.\r\n\r\n## Quick Start\r\n\r\nYou can run this MCP server using npx:\r\n\r\n```bash\r\n# Using environment variables\r\nGITHUB_PERSONAL_ACCESS_TOKEN=your_token npx @slinerodev/github-releases-mcp\r\n\r\n# Or using a .env file\r\necho \"GITHUB_PERSONAL_ACCESS_TOKEN=your_token\" > .env\r\nnpx @slinerodev/github-releases-mcp\r\n```\r\n\r\n## Client Configuration\r\n\r\nThe server can be used with various MCP clients. Add the following configuration to your client's config file:\r\n\r\n- Cursor: `~/.cursor/mcp.json`\r\n- VS Code: `.vscode/settings.json` (use `mcp.servers` instead of `mcpServers`)\r\n- Claude Desktop: `claude_desktop_config.json`\r\n- Windsurf: `windsurf_config.json`\r\n\r\n### Using Published Version\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"github-releases\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\r\n        \"-y\",\r\n        \"@slinerodev/github-releases-mcp\"\r\n      ],\r\n      \"env\": {\r\n        \"GITHUB_PERSONAL_ACCESS_TOKEN\": \"your_token_here\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Using Local Development Version\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"github-releases\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\r\n        \"-y\",\r\n        \"tsx\",\r\n        \"${workspaceRoot}/main.ts\"\r\n      ]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\nNote:\r\n\r\n- For VS Code, replace `mcpServers` with `mcp.servers` in the configuration.\r\n- Replace `your_token_here` with your GitHub Personal Access Token if you want to access private repositories or need higher rate limits.\r\n\r\n## Available Tools\r\n\r\nThe server provides three specialized tools for working with GitHub releases:\r\n\r\n### 1. github_release_info\r\n\r\nGet detailed information about a specific release version.\r\n\r\n```typescript\r\nconst result = await mcp.invoke(\"github_release_info\", {\r\n  owner: \"owner-name\",\r\n  repo: \"repo-name\",\r\n  version: \"1.0.0\" // Supports v1.0.0, @1.0.0, 1.0.0\r\n});\r\n```\r\n\r\nPerfect for:\r\n\r\n- Understanding what changed in a specific version\r\n- Documentation purposes\r\n- Release note retrieval\r\n\r\n### 2. github_releases_compare\r\n\r\nCompare changes between two versions.\r\n\r\n```typescript\r\nconst result = await mcp.invoke(\"github_releases_compare\", {\r\n  owner: \"owner-name\",\r\n  repo: \"repo-name\",\r\n  fromVersion: \"1.0.0\",\r\n  toVersion: \"2.0.0\"\r\n});\r\n```\r\n\r\nPerfect for:\r\n\r\n- Generating changelogs\r\n- Understanding feature evolution\r\n- Migration guides\r\n- Breaking change analysis\r\n\r\n### 3. github_releases_list\r\n\r\nList all releases with filtering options.\r\n\r\n```typescript\r\nconst result = await mcp.invoke(\"github_releases_list\", {\r\n  owner: \"owner-name\",\r\n  repo: \"repo-name\",\r\n  limit: 10, // Optional: limit number of releases\r\n  includePreReleases: false // Optional: include pre-releases\r\n});\r\n```\r\n\r\nPerfect for:\r\n\r\n- Project release history overview\r\n- Finding latest versions\r\n- Release frequency monitoring\r\n- Pre-release tracking\r\n\r\n### Example Response Format\r\n\r\nAll tools return responses in a consistent, emoji-enhanced format:\r\n\r\n```\r\n🔖 v1.0.0 (First stable release)\r\n🗓️ 2024-03-15T10:30:00Z\r\n📝 This is the release description...\r\n\r\n---\r\n\r\n🔖 v0.9.0 (Beta) (Pre-release)\r\n🗓️ 2024-03-01T08:15:00Z\r\n📝 Beta version with new features...\r\n```\r\n\r\n## Error Handling\r\n\r\nThe tools handle various error cases gracefully:\r\n\r\n- Invalid repository names\r\n- Non-existent versions\r\n- Invalid version formats\r\n- API rate limits\r\n- Network issues\r\n- Authentication errors\r\n\r\nEach error returns a clear message explaining what went wrong.\r\n\r\n## Development\r\n\r\n1. Install dependencies:\r\n\r\n    ```bash\r\n    pnpm install\r\n    ```\r\n\r\n2. Run the server:\r\n\r\n    ```bash\r\n    pnpm start\r\n    ```\r\n\r\n## Contributing\r\n\r\n1. Fork the repository\r\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\r\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\r\n4. Push to the branch (`git push origin feature/amazing-feature`)\r\n5. Open a Pull Request\r\n\r\n## License\r\n\r\nISC\r\n\r\n## Author\r\n\r\nSergio Linero\r\n","readmeFilename":"README.md"}