esa-mcp-server

基本能力

产品定位

esa-mcp-server 是一个中间件服务，旨在通过 MCP 协议将 esa.io 的 API 功能集成到其他工具或系统中，方便用户进行文章管理和协作。

核心功能

• 文章搜索：支持通过关键词、排序方式等条件搜索 esa.io 的文章。
• 文章详情获取：支持获取单篇或多篇文章的详细信息。
• MCP 接口：提供符合 MCP 标准的接口，便于与其他工具集成。

适用场景

• 团队协作：在团队协作工具中集成 esa.io 的文章管理功能。
• 内容检索：快速检索和获取团队知识库中的文章。
• 自动化流程：在自动化流程中调用 esa.io 的文章数据。

工具列表

1. search_esa_posts：用于搜索 esa.io 的文章，支持多种查询参数。
2. read_esa_post：获取指定文章编号的文章详情。
3. read_esa_multiple_posts：批量获取多篇文章的详情。

常见问题解答

• 文章搜索时不返回文章正文：为了避免消耗过多的令牌数，搜索时默认不返回文章正文。

使用教程

使用依赖

在开始安装之前，请确保已安装 Node.js 和 npm。

安装教程

1. 在配置文件中添加以下内容：

{
  "mcpServers": {
    "esa-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "esa-mcp-server@latest"
      ]
    },
    "env": {
      "ESA_API_KEY": "your api key here",
      "DEFAULT_ESA_TEAM": "your default esa team"
    }
  }
}

1. 运行以下命令启动服务：

npx -y esa-mcp-server@latest

调试方式

启动服务后，可以通过调用 MCP 接口进行调试。例如，使用 search_esa_posts 工具搜索文章：

curl -X POST http://localhost:3000/mcp/search_esa_posts -d '{"query": "test"}'

许可证

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