Telegram Notes

MCP服务器电报备注

此项目实现了自定义 MCP服务器 它允许您使用Telegram机器人直接向您的Telegram帐户发送便条。它旨在通过Telegram消息平台快速、程序化地传递便条。

什么是MCP服务器？

MCP（模型上下文协议）服务器 是一个实现模型上下文协议的服务器，使工具、资源和提示能够以标准化的方式向AI代理和其他客户端公开。MCP服务器可以提供可以远程调用的自定义工具（如发送笔记），使其在自动化和集成场景中具有高度的可扩展性。

• 模型上下文协议（MCP）文档

什么是Telegram Bot？

A. 电报机器人 是一种由软件而非人工操作的特殊Telegram帐户。机器人可以与用户交互，发送和接收消息，并执行自动化任务。Telegram机器人是使用 @植物学家 Telegram上的机器人。

• Telegram机器人：开发者入门
• Telegram Bot API文档

如何创建Telegram Bot

1. 打开Telegram并搜索 @植物学家 (BotFather文件).
2. 开始聊天并使用 /newbot 创建新机器人的命令。
3. 按照说明为您的机器人设置名称和用户名。
4. 创建后，您将收到 Telegram Bot API代币。保存此令牌；您将需要它进行配置。
5. 与您的新机器人开始聊天（在Telegram中搜索其用户名并发送消息）。
6. 要获取您的个人聊天ID，您可以使用以下工具 用户信息机器人 或向您的聊天机器人发送消息，并使用Telegram API检索聊天ID。

项目文件夹结构

├── package.json
├── README.md
├── tsconfig.json
├── .env                # Your environment variables (not committed)
├── src/
│   ├── env.ts          # Loads and validates environment variables
│   └── index.ts        # Main MCP server logic and Telegram integration

运作原理

1. 服务器是使用模型上下文协议SDK构建的，并公开了一个名为 send-note.
2. 时中 send-note 当工具被调用（远程或本地）时，它会使用您的机器人向您的Telegram帐户发送一条消息。
3. 服务器从环境变量中读取您的机器人令牌和聊天ID，然后使用Telegram bot API传递消息。
4. 该项目是用TypeScript编写的，可以在开发模式下运行，也可以为生产环境构建。

安装说明

1. 创建一个 .env 文件 在项目根目录中使用以下变量：

- TELEGRAM_TOKEN：您的Telegram机器人API令牌（来自@BotFather） - TELEGRAM_PERSONAL_CHAT_ID：您的个人聊天ID（您与机器人聊天的标识符）

1. 安装依赖项：

   npm install

1. 在开发模式下运行服务器：

   npm run dev

1. 构建并投入生产：

   npm run build
   npm start

环境变量

创建一个 .env 文件并添加这些变量：

1. TELEGRAM_TOKEN：Telegram bot API令牌（使用Telegram和@BotFather检索API令牌）
2. TELEGRAM_PERSONAL_CHAT_ID：聊天ID（您和Telegram机器人之间的聊天标识符；与您的用户ID重叠）

在VSCode中使用MCP服务器的设置说明

创建一个 mcp.json 文件在 .vscode 文件夹。

注： dz-telegram-notes-dev 旨在为发展而努力。

{
	"servers": {
		"dz-telegram-notes-dev": {
			"type": "stdio",
			"command": "npm",
			"args": [
				"run",
				"dev"
			],
			"cwd": "${workspaceFolder}",
			"dev": {
				"watch": "src/**/*.ts",
				"debug": {
					"type": "node"
				}
			}
		},
		"dz-telegram-notes-prod": {
			"type": "stdio",
			"command": "npm",
			"args": [
				"run",
				"start"
			],
			"cwd": "${workspaceFolder}"
		},
	},
}

Claude Desktop的安装说明

在中添加“mcp电报注释” claude_desktop_config.json 文件

{
  "mcpServers": {
	// ...
    "mcp-telegram-notes": {
      "command": "node",
      "args": [
        "PATH_TO_YOUR/dist/index.js"
      ],
      "env": {
        "TELEGRAM_TOKEN": "YourTelegramToken",
        "TELEGRAM_PERSONAL_CHAT_ID": "YourChatId"
      }
    }
	// ...
  },
}