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[];
}

🤝 貢獻

歡迎貢獻。