{"_id":"@cyuanxv/telegram-bot-mcp-server","_rev":"3-9cf55b5848ea431488ed33f7488bc8e9","name":"@cyuanxv/telegram-bot-mcp-server","dist-tags":{"latest":"1.0.1"},"versions":{"0.0.0-stage":{"name":"@cyuanxv/telegram-bot-mcp-server","version":"0.0.0-stage","_id":"@cyuanxv/telegram-bot-mcp-server@0.0.0-stage","stub":true,"maintainers":[{"name":"cyuanxv","email":"cyuanxv@gmail.com"}],"dist":{"shasum":"944bb7b67af6337e2d1d037feb45d78444b22c97","tarball":"https://registry.npmjs.org/@cyuanxv/telegram-bot-mcp-server/-/telegram-bot-mcp-server-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-VOnW8e+twTOSQh1MPzgWtlkwlDDJ4iR7EsrPzL4yxlbLaxlXFnRF0EF8PJ00flugSsVYsluJYtzUOKh8KJ1YVw==","signatures":[{"sig":"MEQCIGTSMQ660Krx+OLDqTsrjWP95oxFKaGIlTJwQQkrScMuAiAWLLj2efcH1A/MccoO7Tw3t5JV68FoEanCv8hGH7eRng==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":354},"_npmUser":{"name":"cyuanxv","email":"cyuanxv@gmail.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"1.0.0":{"name":"@cyuanxv/telegram-bot-mcp-server","version":"1.0.0","keywords":["telegram","telegram-bot","mcp","mcp-server","model-context-protocol","self-hosted"],"author":{"name":"cyuanxv"},"license":"MIT","_id":"@cyuanxv/telegram-bot-mcp-server@1.0.0","maintainers":[{"name":"cyuanxv","email":"cyuanxv@gmail.com"}],"homepage":"https://github.com/cyuanxv/telegram-bot-mcp-server#readme","bugs":{"url":"https://github.com/cyuanxv/telegram-bot-mcp-server/issues"},"bin":{"telegram-bot-mcp-server":"bin/telegram-bot-mcp-server.mjs"},"dist":{"shasum":"f7facccd20a3c00f3bdbefc8dc746aaedf0025c0","tarball":"https://registry.npmjs.org/@cyuanxv/telegram-bot-mcp-server/-/telegram-bot-mcp-server-1.0.0.tgz","fileCount":151,"integrity":"sha512-7KGlEQuNvaYWK9jBE5pFbf51YQ/lrnmNqLKI65NiEzvZY/tpo/ZJK/7i8Az44oaJrwzVVxgHwZmRH5sD2RXnPg==","signatures":[{"sig":"MEUCIQDoLTxxeNVLBzrM3mT08SU+jjIW9A9pR6yNh9Cn1Li6jwIgXPmjm/Pxq+7lEiStyE7RagW4aFX+3TrgTIchoMpnaCg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQC1T9nXDTZSdDp7u7Pb8LC1CbItgS5SLB0Ty0/oCL1RxgIhALyCAU2GOF7n7499OoJuYkqA9ztq/xxKPGkdbWPQ6JFH","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":597719},"_from":"file:/Users/lilimeng/Downloads/telegram-bot-mcp-server-final-review-20261022/artifacts/cyuanxv-telegram-bot-mcp-server-1.0.0.tgz","engines":{"node":"24.x"},"mcpName":"io.github.cyuanxv/telegram-bot-mcp-server","private":false,"scripts":{"dev":"next dev","test":"node --experimental-test-module-mocks --import ./tests/register-typescript.mjs --test tests/*.test.mjs","build":"next build","inbox":"node dist-delivery/scripts/inbox-cli.js","queue":"node dist-delivery/scripts/delivery-cli.js","serve":"node bin/telegram-bot-mcp-server.mjs","start":"next start","typecheck":"tsc --noEmit","demo:vault":"node --import ./tests/register-typescript.mjs scripts/vault-demo.mjs","demo:report":"node --import ./tests/register-typescript.mjs scripts/report-demo.mjs","test:review":"node --test-concurrency=2 --experimental-test-module-mocks --import ./tests/register-typescript.mjs --test review/*.test.mjs","test:package":"node --test tests/package-cli.test.mjs","test:protocol":"node tests/protocol-smoke.mjs","build:delivery":"tsc -p tsconfig.delivery.json","check:registry":"node scripts/check-registry.mjs"},"_npmUser":{"name":"cyuanxv","email":"cyuanxv@gmail.com"},"_resolved":"/Users/lilimeng/Downloads/telegram-bot-mcp-server-final-review-20261022/artifacts/cyuanxv-telegram-bot-mcp-server-1.0.0.tgz","_integrity":"sha512-7KGlEQuNvaYWK9jBE5pFbf51YQ/lrnmNqLKI65NiEzvZY/tpo/ZJK/7i8Az44oaJrwzVVxgHwZmRH5sD2RXnPg==","repository":{"url":"git+https://github.com/cyuanxv/telegram-bot-mcp-server.git","type":"git","directory":"server"},"_npmVersion":"11.13.0","description":"Self-hosted Telegram Bot MCP server for rich text, media and interactive buttons.","directories":{},"_nodeVersion":"24.16.0","dependencies":{"pg":"8.23.1","zod":"4.6.5","next":"16.3.8","react":"19.3.0","@types/pg":"8.23.1","react-dom":"19.3.0","teleproto":"1.229.1","typescript":"5.9.3","@types/node":"24.19.1","big-integer":"1.6.52","mcp-handler":"2.2.0","@types/react":"19.3.0"},"_hasShrinkwrap":true,"devDependencies":{"@electric-sql/pglite":"^0.5.8"},"_npmOperationalInternal":{"tmp":"tmp/telegram-bot-mcp-server_1.0.0_1792675511627_0.21431730153766515","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"_id":"@cyuanxv/telegram-bot-mcp-server@1.0.1","bin":{"telegram-bot-mcp-server":"bin/telegram-bot-mcp-server.mjs"},"bugs":{"url":"https://github.com/cyuanxv/telegram-bot-mcp-server/issues"},"dist":{"shasum":"99b261602e208dad561de0da94799926fee6c144","tarball":"https://registry.npmjs.org/@cyuanxv/telegram-bot-mcp-server/-/telegram-bot-mcp-server-1.0.1.tgz","fileCount":168,"integrity":"sha512-9KY6gkOg/eIHFi4wx66mJzlBe/tbwF/MhiWhZv9ymnDKQSvlUDMcxw6Dy3MtFcObpdp6JgMbQG+Z00tRamExEQ==","signatures":[{"sig":"MEYCIQCiKt2PoPgvdQ/c7U6DCzjh1KH2qHUgC7kdL69Zt9+n3QIhANHx2x1PCXHonsLT+o0jdZpTradgavkeGBZBFUFsDhsk","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDBTAIHOVIHBgeqU+hO7ttCLEnwPvH50TQMkb/LivkX6wIgV8uxG6ttnwdO5sPur4TgKLkg/saCCXwrvxZIir87BJw="}],"unpackedSize":649577},"name":"@cyuanxv/telegram-bot-mcp-server","_from":"file:../cyuanxv-telegram-bot-mcp-server-1.0.1.tgz","author":{"name":"cyuanxv"},"engines":{"node":"24.x"},"license":"MIT","mcpName":"io.github.cyuanxv/telegram-bot-mcp-server","private":false,"scripts":{"dev":"next dev","test":"node --experimental-test-module-mocks --import ./tests/register-typescript.mjs --test tests/*.test.mjs","build":"next build","inbox":"node dist-delivery/scripts/inbox-cli.js","queue":"node dist-delivery/scripts/delivery-cli.js","serve":"node bin/telegram-bot-mcp-server.mjs","start":"next start","typecheck":"tsc --noEmit","demo:vault":"node --import ./tests/register-typescript.mjs scripts/vault-demo.mjs","demo:report":"node --import ./tests/register-typescript.mjs scripts/report-demo.mjs","test:review":"node --test-concurrency=2 --experimental-test-module-mocks --import ./tests/register-typescript.mjs --test review/*.test.mjs","test:package":"node --test tests/package-cli.test.mjs","test:protocol":"node tests/protocol-smoke.mjs","build:delivery":"tsc -p tsconfig.delivery.json","check:registry":"node scripts/check-registry.mjs"},"version":"1.0.1","_npmUser":{"name":"cyuanxv","email":"cyuanxv@gmail.com"},"homepage":"https://github.com/cyuanxv/telegram-bot-mcp-server#readme","keywords":["telegram","telegram-bot","mcp","mcp-server","model-context-protocol","self-hosted"],"_resolved":"/Users/lilimeng/agent-cockpit-workspace/.worktrees/tasks/telegram-public-release-101-20261024/workspace/.cockpit-runs/release/cyuanxv-telegram-bot-mcp-server-1.0.1.tgz","_integrity":"sha512-9KY6gkOg/eIHFi4wx66mJzlBe/tbwF/MhiWhZv9ymnDKQSvlUDMcxw6Dy3MtFcObpdp6JgMbQG+Z00tRamExEQ==","repository":{"url":"git+https://github.com/cyuanxv/telegram-bot-mcp-server.git","type":"git","directory":"server"},"_npmVersion":"11.13.0","description":"Self-hosted Telegram Bot MCP server for rich text, media and interactive buttons.","directories":{},"maintainers":[{"name":"cyuanxv","email":"cyuanxv@gmail.com"}],"_nodeVersion":"24.16.0","dependencies":{"pg":"8.23.1","zod":"4.6.7","next":"16.4.3","react":"19.3.0","@types/pg":"8.23.1","react-dom":"19.3.0","teleproto":"1.229.1","typescript":"5.9.3","@types/node":"24.19.1","big-integer":"1.6.52","mcp-handler":"2.2.0","@types/react":"19.3.0"},"_hasShrinkwrap":true,"devDependencies":{"@electric-sql/pglite":"^0.5.8"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/telegram-bot-mcp-server_1.0.1_1792853887907_0.960176450722446"}}},"time":{"created":"2026-10-22T13:21:01.676Z","modified":"2026-10-24T14:58:08.189Z","0.0.0-stage":"2026-10-22T13:21:01.676Z","1.0.0":"2026-10-22T13:25:11.734Z","1.0.1":"2026-10-24T14:58:08.010Z"},"bugs":{"url":"https://github.com/cyuanxv/telegram-bot-mcp-server/issues"},"author":{"name":"cyuanxv"},"license":"MIT","homepage":"https://github.com/cyuanxv/telegram-bot-mcp-server#readme","keywords":["telegram","telegram-bot","mcp","mcp-server","model-context-protocol","self-hosted"],"repository":{"url":"git+https://github.com/cyuanxv/telegram-bot-mcp-server.git","type":"git","directory":"server"},"description":"Self-hosted Telegram Bot MCP server for rich text, media and interactive buttons.","maintainers":[{"name":"cyuanxv","email":"cyuanxv@gmail.com"}],"readme":"# Telegram Bot MCP Server\n\n[中文](README.md) · [English](README.en.md)\n\n为 AI 助手连接 Telegram Bot，支持富文本、多媒体消息和交互按钮，可自行部署。\n\n`telegram-bot-mcp-server` 通过 MCP（模型上下文协议）让兼容客户端使用你自己的 Telegram Bot。服务运行在你控制的环境中，Bot 凭据由你配置和保管。\n\n[安装教程](docs/QUICKSTART.md) · [常见问题](docs/FAQ.md) · [功能与配置要求](docs/FEATURES.md) · [反馈问题](https://github.com/cyuanxv/telegram-bot-mcp-server/issues)\n\n## 你可以用它做什么\n\n- 把 AI 整理的日报、摘要发送到自己的 Telegram 会话。\n- 将文字、图片和文件交付给团队，随后按需要编辑消息。\n- 为消息添加链接、复制按钮；需要用户反馈时再配置回调。\n\n## 使用 npm 开始\n\n需要 Node.js 24，先设置自己的 `MCP_API_KEY` 进程环境，再运行：\n\n```sh\nnpx --yes @cyuanxv/telegram-bot-mcp-server@1.0.1 --port 3000\n```\n\n首次启动会编译源码。连接地址为 `http://127.0.0.1:3000/api/mcp`，使用 Streamable HTTP，并携带 `Authorization: Bearer <你的 MCP_API_KEY>`。真实发送还需你自己的 Bot token 和目标 chat ID。\n\n[按步骤安装](docs/QUICKSTART.md) · [npm 安装包](https://www.npmjs.com/package/@cyuanxv/telegram-bot-mcp-server) · [1.0.1 Release](https://github.com/cyuanxv/telegram-bot-mcp-server/releases/tag/v1.0.1) · [官方 MCP Registry 条目](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.cyuanxv%2Ftelegram-bot-mcp-server/versions/1.0.1)\n\n## 主要功能\n\n- **富文本与编辑**：普通文字、HTML、MarkdownV2，以及已发送消息的编辑。\n- **多媒体消息**：图片、视频、文件、音频、GIF、语音和贴纸。\n- **Rich Messages**：标题、表格、公式、正文穿插图片，以及音视频混排。\n- **交互按钮**：链接、复制文字和需要回调配置的交互操作。\n- **自行部署**：提供后端源码、自动测试、数据库迁移和安装说明。\n\n各功能的配置要求见[功能说明](docs/FEATURES.md)。本仓库提供后端源码，不包含 Sites 网页入口、Docker 镜像或预装依赖。本项目并非 Telegram 官方产品。\n\n## 作者\n\n© 2026 cyuanxv · [X / Twitter @cyuanxv](https://x.com/cyuanxv)\n\n## 从这里开始\n\n[npm 安装教程](docs/QUICKSTART.md) · [源码与本地安装包说明](docs/PACKAGE-INSTALL.md) · [Registry 发布维护说明](docs/REGISTRY-PUBLISHING.md)\n\n1. [从零安装](docs/GETTING-STARTED.md)：安装、配置、启动，以及如何确认连接成功。\n2. [配置说明](docs/CONFIGURATION.md)：最少需要填什么、哪些高级功能先保持关闭。\n3. [功能边界](docs/FEATURES.md)：基础功能、条件功能与实验功能。\n4. [常见问题](docs/FAQ.md)：创建 Bot、安装与连接、发送排查；[开发排错](docs/TROUBLESHOOTING.md)补充源码检查。\n5. [当前验收范围](docs/ACCEPTANCE.md)：本次全新安装做了什么，哪些还没验证。\n\n以下为源码开发方式；日常安装请优先看上面的 npm 教程。使用 Node.js 24 和随附的 npm。解压后所有后端命令都在 `server/` 目录执行，不要在本包根目录执行 `npm ci`。\n\n```sh\ncd telegram-bot-mcp-server/server\nnpm ci --ignore-scripts\ncp .env.example .env.local\n# 用编辑器填 MCP_API_KEY；有自己的测试 Bot 时再填 token 和 chat ID\nnpm run dev -- --hostname 127.0.0.1\n```\n\nMCP 地址：`http://127.0.0.1:3000/api/mcp`。客户端请求需带 `Authorization: Bearer <你的 MCP_API_KEY>`。云端客户端通常不能访问你的本机地址，需要你自行部署 HTTPS 后端。\n\n没有真实 Bot 也能启动并运行合成测试，但不能据此声称已向 Telegram 发出消息。不要把 Bot token、MCP 密钥或验证码贴入聊天、截图或 Git。\n\n## 检查命令\n\n在 `server/`：\n```sh\nnpm test\nnpm run test:review\nnpm run typecheck\nnpm run build:delivery\nnpm run build\nnpm run test:protocol\n```\n\n低内存设备可用 `node --test-concurrency=2 --experimental-test-module-mocks --import ./tests/register-typescript.mjs --test tests/*.test.mjs` 代替 `npm test`。协议检查只连接本机，端口3130须空闲；运行时不要加载真实 Bot 配置。\n\n已有本地安装验收不等于云端部署、真实 Bot 或客户端效果验收。\n\n## 安全与许可\n\nMCP 密钥只给可信操作者：基础接口包含发送、编辑和管理工具，可选择原始 chat ID，配置别名不是完整的收件人白名单。不要把它作为无需认证的公开消息服务。\n\n已知依赖风险见 [已知问题](docs/KNOWN-ISSUES.md)。源码沿用 [MIT](LICENSE) 及原版权声明，第三方条款见 [第三方声明](THIRD_PARTY_NOTICES.md)。自有代码版权由cyuanxv持有，已确认采用MIT；不覆盖第三方依赖的原许可。反馈前请按 [安全说明](SECURITY.md) 删除凭据。\n\n## 版权\n\n© 2026 cyuanxv · [X / Twitter @cyuanxv](https://x.com/cyuanxv)\n\n自有代码采用 [MIT 许可证](LICENSE)，第三方依赖保留各自的版权和许可。\n","readmeFilename":"README.md"}