D Kimuson Esa MCP Server

🚀 esa-mcp-server

esa-mcp-server 是一个借助 Model Context Protocol (MCP) 接口，来调用 esa.io API 的服务器。它为用户提供了便捷的方式来与 esa.io 进行交互。

🚀 快速开始

根据使用的工具，准备以下配置文件：

{
  "mcpServers": {
    "esa-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "esa-mcp-server@latest"
      ]
    },
    "env": {
      "ESA_API_KEY": "你的 API 密钥",
      "DEFAULT_ESA_TEAM": "你默认的 esa 团队"
    }
  }
}

✨ 主要特性

• 🔍 esa.io 的文章搜索：可快速在 esa.io 上查找所需文章。
• 📖 获取单篇或多篇文章的详细信息：满足不同场景下对文章信息的获取需求。
• 🛠️ 提供符合 MCP 标准的接口：便于与其他遵循 MCP 标准的系统进行集成。

💻 使用示例

基础用法

search_esa_posts

搜索 esa.io 的文章。

type SearchPostsParams = {
  teamName?: string;
  query: string;
  order?: "asc" | "desc";
  sort?: "created" | "updated" | "number" | "stars" | "comments" | "best_match";
  page?: number;
  perPage?: number;
}

esa 的文章搜索 API 返回文章内容，但 MCP Server 响应中不包含这些内容。这是因为在搜索时返回所有命中文章的内容会严重消耗令牌数。有关各参数的用途，请参阅 esa API v1 官方文档。

read_esa_post

获取指定编号的文章。

type ReadPostParams = {
  teamName?: string;
  postNumber: number;
}

read_esa_multiple_posts

批量获取多个文章编号的内容。

type ReadMultiplePostsParams = {
  teamName?: string;
  postNumbers: number[];
}

🤝 贡献

欢迎贡献。