内容
# 电报 MCP 服务器（Python）
一个模型上下文协议（MCP）服务器，提供与电报 API（telegra.ph）交互的工具。此 Python 实现允许 Claude 和其他 LLM 客户端创建、管理和导出电报页面。
## 功能
- **账户管理**：创建账户、更新信息、管理访问令牌
- **页面操作**：创建、编辑、检索和列出页面
- **模板系统**：使用预建模板创建页面
- **导出和备份**：导出页面为 Markdown/HTML，备份整个账户
- **MCP 资源**：访问电报页面作为 MCP 资源
- **MCP 提示**：常见任务的引导工作流
## 安装
### 使用 uvx（推荐）
```bash
uvx telegraph-mcp-py
```
### 使用 pip
```bash
pip install telegraph-mcp-py
```
### 从源码
```bash
git clone https://github.com/NehoraiHadad/telegraph-mcp
cd telegraph-mcp/telegraph-mcp-py
pip install -e .
```
## 使用
### 与 Claude 代码
```bash
claude mcp add telegraph-py -- uvx telegraph-mcp-py
```
### 与 Claude 桌面版
添加到您的 Claude 桌面版配置（`~/.config/claude/claude_desktop_config.json`）：
```json
{
"mcpServers": {
"telegraph-py": {
"command": "uvx",
"args": ["telegraph-mcp-py"]
}
}
}
```
或如果通过 pip 安装：
```json
{
"mcpServers": {
"telegraph-py": {
"command": "telegraph-mcp-py"
}
}
}
```
## 可用工具
### 账户管理
| 工具 | 描述 |
|------|-------------|
| `telegraph_create_account` | 创建新的电报账户 |
| `telegraph_edit_account_info` | 更新账户信息 |
| `telegraph_get_account_info` | 获取账户详情 |
| `telegraph_revoke_access_token` | 撤销并重新生成访问令牌 |
### 页面管理
| 工具 | 描述 |
|------|-------------|
| `telegraph_create_page` | 创建新页面（支持 HTML/Markdown） |
| `telegraph_edit_page` | 编辑现有页面 |
| `telegraph_get_page` | 按路径获取页面 |
| `telegraph_get_page_list` | 列出账户的所有页面 |
| `telegraph_get_views` | 获取页面浏览统计 |
### 模板
| 工具 | 描述 |
|------|-------------|
| `telegraph_list_templates` | 列出可用模板 |
| `telegraph_create_from_template` | 从模板创建页面 |
### 导出和备份
| 工具 | 描述 |
|------|-------------|
| `telegraph_export_page` | 导出页面为 Markdown/HTML |
| `telegraph_backup_account` | 备份所有账户页面 |
## 资源
直接访问电报页面作为 MCP 资源：
```
telegraph://page/{path}
```
示例：`telegraph://page/示例页面-12-15`
## 提示
预定义提示用于引导工作流：
- `create_blog_post` - 创建博客文章的指南
- `create_documentation` - 创建文档的指南
- `summarize_page` - 总结现有页面的指南
## 示例
### 使用 Markdown 创建页面
```python
# 通过 MCP 工具调用
telegraph_create_page(
access_token="您的令牌",
title="我的第一篇文章",
content="# 你好，世界\n\n这是我的第一个电报页面！",
format="markdown"
)
```
### 使用模板
```python
telegraph_create_from_template(
access_token="您的令牌",
template="blog_post",
title="我的博客文章",
data={
"intro": "欢迎来到我的博客！",
"sections": [
{"heading": "第 1 部分", "content": "第一部分内容"},
{"heading": "第 2 部分", "content": "第二部分内容"}
],
"conclusion": "感谢阅读！"
}
)
```
### 导出页面
```python
telegraph_export_page(
path="示例页面-12-15",
format="markdown"
)
```
## 开发
### 设置
```bash
cd telegraph-mcp-py
pip install -e ".[dev]"
```
### 使用 MCP 检验器测试
```bash
npx @modelcontextprotocol/inspector uvx telegraph-mcp-py
```
## 相关软件包
- [telegraph-mcp](https://www.npmjs.com/package/telegraph-mcp) - TypeScript MCP 服务器
- [telegraph-api-py](https://pypi.org/project/telegraph-api-py/) - Python 电报客户端
- [telegraph-api-client](https://www.npmjs.com/package/telegraph-api-client) - TypeScript 电报客户端
## 许可证
MIT 许可证 - 参见 [LICENSE](LICENSE) 获取详细信息。
