ESA MCP Server

基本能力

产品定位

ESA MCP Server 是一个与 esa.io API 集成的 MCP 服务器，主要用于管理和操作 esa.io 上的文章和用户信息。

核心功能

• 用户信息获取
• 文章列表获取
• 文章详情获取
• 文章创建
• 文章更新
• 文章删除

适用场景

• 在 Cursor 中作为 MCP 服务器使用
• 自动化管理 esa.io 上的文章
• 集成 esa.io API 到其他应用中

工具列表

• deno run --allow-env --allow-net=api.esa.io --allow-read jsr:@masseater/esa-mcp-server: 运行 MCP 服务器
• deno task dev: 本地开发时启用热重载
• deno task check:all: 运行格式检查、lint、类型检查和单元测试
• deno task test:integration: 运行集成测试

常见问题解答

• 如何获取 esa.io API 令牌？ 访问你的 esa.io 团队页面，点击右上角的个人图标，选择“设置”>“应用程序”，在“个人访问令牌”部分生成新令牌。
• 如何设置环境变量？ 在项目根目录创建 .env 文件，并设置 ESA_TEAM_NAME 和 ESA_TOKEN。

使用教程

使用依赖

• Deno v2.0 或更高版本
• 互联网连接

安装教程

1. 安装 Deno v2.0 或更高版本
2. 创建 .env 文件并设置环境变量 dotenv ESA_TEAM_NAME="YOUR_ESA_TEAM_NAME" ESA_TOKEN="YOUR_ESA_API_TOKEN"
3. 运行 MCP 服务器 bash deno run --allow-env --allow-net=api.esa.io --allow-read jsr:@masseater/esa-mcp-server

调试方式

• 检查 .env 文件是否正确设置
• 确保 Deno 版本符合要求
• 运行 deno task check:all 检查代码问题
• 运行 deno task test:integration 进行集成测试

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。