企业搜索分析-MCP服务器

Name: 企业搜索分析-MCP服务器
Author: kajirita2002

作者：kajirita20028 星标更新：2025-03-27

安装使用来源：spider==github.com

项目介绍

esa MCP Server

阅读此文档的日语版本

概述

该服务器使用模型上下文协议（MCP），使Claude AI能够与esa API进行交互。

通过这个MCP服务器，Claude AI可以执行诸如搜索、创建和更新esa文档等操作。

关于仓库

此仓库提供了一个独立实现的esa MCP服务器。它将Claude AI与esa集成，以简化文档管理。

安装

预备条件

Node.js 18或更高版本
esa API访问令牌
esa团队名称

安装

# 全局安装
npm install -g @kajirita2002/esa-mcp-server

# 或直接使用npx
npx @kajirita2002/esa-mcp-server

设置环境变量

# 设置环境变量
export ESA_ACCESS_TOKEN="your_esa_access_token"
export ESA_TEAM="your_team_name"

MCP配置示例

如果你正在使用这个MCP服务器，请在你的mcp_config.json文件中添加以下配置：

"esa": {
  "command": "npx",
  "args": ["-y", "@kajirita2002/esa-mcp-server"],
  "env": {
    "ESA_ACCESS_TOKEN": "your_esa_access_token",
    "ESA_TEAM": "your_team_name"
  }
}

启动服务器

# 启动服务器
npm start

可用工具

此MCP服务器提供了以下工具：

文章相关

esa_list_posts
- 获取团队中的文章列表
- 输入：
  - q (字符串，可选)：搜索查询
  - include (字符串，可选)：包含在响应中的相关数据（例如 'comments,stargazers'）
  - sort (字符串，可选)：排序方法（updated, created, number, stars, watches, comments, best_match）
  - order (字符串，可选)：排序顺序（desc, asc）
  - per_page (数字，可选)：每页结果数量（最大值：100）
  - page (数字，可选)：要检索的页码
esa_get_post
- 获取特定文章的详细信息
- 输入：
  - post_number (数字，必需)：要检索的文章编号
  - include (字符串，可选)：包含在响应中的相关数据（例如 'comments,stargazers'）
esa_create_post
- 创建新文章
- 输入：
  - name (字符串，必需)：文章标题
  - body_md (字符串，可选)：文章正文（Markdown格式）
  - tags (字符串数组，可选)：文章标签列表
  - category (字符串，可选)：文章类别
  - wip (布尔值，可选，默认为true)：是否标记为WIP（正在进行的工作）
  - message (字符串，可选)：变更消息
  - user (字符串，可选)：发布者的screen_name（仅团队所有者可以指定）
  - template_post_id (数字，可选)：作为模板的文章ID
esa_update_post
- 更新现有文章
- 输入：
  - post_number (数字，必需)：要更新的文章编号
  - name (字符串，可选)：文章的新标题
  - body_md (字符串，可选)：文章的新正文（Markdown格式）
  - tags (字符串数组，可选)：文章的新标签列表
  - category (字符串，可选)：文章的新类别
  - wip (布尔值，可选)：是否标记为WIP（正在进行的工作）
  - message (字符串，可选)：变更消息
  - created_by (字符串，可选)：发布者的screen_name（仅团队所有者可以指定）
  - original_revision (字符串，可选)：更新的基础修订版

评论相关

esa_list_comments
- 获取文章的评论列表
- 输入：
  - post_number (数字，必需)：要获取评论的文章编号
  - page (数字，可选)：要检索的页码
  - per_page (数字，可选)：每页结果数量（最大值：100）
esa_get_comment
- 获取特定评论
- 输入：
  - comment_id (数字，必需)：要检索的评论ID
  - include (字符串，可选)：包含在响应中的相关数据（例如 'stargazers'）
esa_create_comment
- 在文章上发表评论
- 输入：
  - post_number (数字，必需)：要评论的文章编号
  - body_md (字符串，必需)：评论正文（Markdown格式）
  - user (字符串，可选)：发布者的screen_name（仅团队所有者可以指定）

成员相关

esa_get_members
- 获取团队成员列表
- 输入：
  - page (数字，可选)：要检索的页码
  - per_page (数字，可选)：每页结果数量（最大值：100）
esa_get_member
- 获取特定团队成员的信息
- 输入：
  - screen_name_or_email (字符串，必需)：要检索的成员的screen_name或电子邮件地址

使用示例

这里是一个Claude使用此MCP服务器创建一个esa文章的例子：

[Claude] 请在esa中创建一个新的文章。标题应为“项目X进度报告”，正文应包括“# 这周的进展\n\n- 特性A的实现已完成\n- 特性B的测试已开始\n\n## 下周计划\n\n- 开始特性C的实现”。

[MCP Server] 使用esa_create_post工具来创建新的文章。

[结果]
{
  "number": 123,
  "name": "项目X进度报告",
  "body_md": "# 这周的进展\n\n- 特性A的实现已完成\n- 特性B的测试已开始\n\n## 下周计划\n\n- 开始特性C的实现",
  "wip": false,
  "created_at": "2023-06-01T12:34:56+09:00",
  "updated_at": "2023-06-01T12:34:56+09:00",
  "url": "https://your-team.esa.io/posts/123"
}

[Claude] 文章已成功创建。文章编号是123，你可以通过以下URL访问：
https://your-team.esa.io/posts/123

故障排除

访问令牌问题

错误：请求失败，状态代码401

如果看到此错误，你的esa访问令牌可能无效或已过期。从esa设置界面生成新的访问令牌并更新你的环境变量。

权限问题

错误：请求失败，状态代码403

如果看到此错误，当前的访问令牌没有必要的权限。检查你在esa设置界面的访问令牌权限，并根据需要发出新的令牌。

许可证

本项目在MIT许可证下提供。