[!IMPORTANT] 正式的MCP服务器已发布。请从此以后使用官方服务器。
这是为esa.io提供的模型上下文协议(MCP)服务器。
在使用此MCP服务器之前,您需要从您的esa.io团队生成一个个人访问令牌:
https://<TEAM_NAME>.esa.io/user/applications您可以使用npx或Docker来运行服务器。
在您的MCP客户端中添加以下配置:
{
"mcpServers": {
"esa": {
"command": "npx",
"args": [
"-y",
"@koki-develop/esa-mcp-server@latest"
],
"env": {
"ESA_TEAM": "<your-team-name>",
"ESA_ACCESS_TOKEN": "<your-personal-access-token>"
}
}
}
}
将<your-team-name>和<your-personal-access-token>替换为您自己的团队名称和个人访问令牌。
如果您更喜欢使用Docker,请使用以下配置:
{
"mcpServers": {
"esa": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ESA_TEAM",
"-e",
"ESA_ACCESS_TOKEN",
"ghcr.io/koki-develop/esa-mcp-server:latest"
],
"env": {
"ESA_TEAM": "<your-team-name>",
"ESA_ACCESS_TOKEN": "<your-personal-access-token>"
}
}
}
}
要启用仅允许读取操作的只读模式,请添加--readonly标志。
使用npx:
{
"mcpServers": {
"esa": {
"command": "npx",
"args": [
"-y",
"@koki-develop/esa-mcp-server@latest",
"--readonly"
],
"env": {
"ESA_TEAM": "<your-team-name>",
"ESA_ACCESS_TOKEN": "<your-personal-access-token>"
}
}
}
}
使用Docker:
{
8"mcpServers": {
"esa": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ESA_TEAM",
"-e",
"ESA_ACCESS_TOKEN",
"ghcr.io/koki-develop/esa-mcp-server:latest",
"--readonly"
],
"env": {
"ESA_TEAM": "<your-team-name>",
"ESA_ACCESS_TOKEN": "<your-personal-access-token>"
}
}
}
}
在只读模式下,只有以下操作可用:
get_posts - 获取帖子列表get_post - 获取特定帖子get_tags - 获取标签get_post_comments - 获取帖子评论写入操作(如create_post、update_post、delete_post、create_post_comment、update_comment、delete_comment)被禁用。
| 工具 | 描述 |
|---|---|
get_posts | 从esa团队获取帖子列表。支持搜索查询、过滤、排序和分页。返回帖子元数据,包括标题、内容、标签、类别、作者信息和互动指标(评论、星标、关注)。可选地包含评论和星标者,支持嵌套包含如'comments,comments.stargazers'。注意:帖子内容(body_md)被截断到300个字符,并通过body_truncated字段指示是否发生截断,以减少上下文大小。 |
get_post | 根据帖子编号从esa团队获取特定帖子。返回完整的帖子详情,包括标题、内容(Markdown)、标签、类别、作者信息、修订历史和互动指标。可选地包含评论和星标者,支持嵌套包含如'comments,comments.stargazers'。 |
create_post | 在esa团队创建新帖子。需要标题,可选地接受内容、标签、类别、WIP状态和其他元数据。返回创建的帖子信息,包括分配的帖子编号和URL。 |
update_post | 更新esa团队中的现有帖子。需要帖子编号,可选地接受更新的内容、标签、类别、WIP状态和其他元数据。返回更新的帖子信息,包括修订详情。 |
delete_post | 删除esa团队中的现有帖子。需要帖子编号。该帖子将被永久删除且无法恢复。成功删除后返回确认消息。 |
| 工具 | 描述 |
|---|---|
get_tags | 获取esa团队中所有使用的标签列表。返回标签及其名称以及它们所附带的帖子数量,按帖子数量降序排列。支持分页。 |
| 工具 | 描述 |
|---|---|
get_post_comments | 获取特定帖子的评论列表。需要帖子编号并支持分页。返回评论元数据,包括内容、作者信息、时间戳和互动指标(星标)。 |
create_post_comment | 在esa团队的现有帖子上创建新的评论。需要帖子编号和Markdown格式的评论内容。返回创建的评论信息,包括ID、内容、时间戳和作者详情。 |
update_comment | 更新esa团队帖子上的现有评论。需要评论ID和新的Markdown格式内容。返回更新的评论信息,包括内容、时间戳和作者详情。 |
delete_comment | 删除esa团队中的现有评论。需要评论ID。该评论将被永久删除且无法恢复。成功删除后返回确认消息。 |
本项目根据MIT许可证授权 - 查看LICENSE文件以获取详细信息。
版权所有 (c) 2025 Koki Sato