Yapi Fetch MCP Server

@xiaozhi666666

代码仓库

基本信息

分类

浏览器自动化

传输方式

stdio

作者

xiaozhi666666

提交者

xiangzhi xu

关于 Yapi Fetch MCP Server

Reusable MCP server for reading YApi interface metadata from a URL, interface ID, or project ID.

#yapi-mcp-fetch-https-typescript

Yapi Fetch MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "yapi": {
      "command": "npx",
      "args": [
        "-y",
        "yapi-fetch-mcp"
      ],
      "env": {
        "YAPI_HOST": "https://yapi.example.com",
        "YAPI_TOKEN": "project-token"
      }
    }
  }
}

Yapi Fetch MCP Server 工具

Read one YApi interface by URL or interface ID and return normalized request/response metadata.

Read a YApi project's interface menu. Useful for discovering interface IDs before calling get_interface.

Search/list YApi project interfaces with pagination.

概览

What is Yapi Fetch Mcp?

Yapi Fetch Mcp is an MCP server for reading YApi interface metadata. It can fetch interface path, request parameters, request body, and response structure via YApi page URL, interface ID, or project ID. It is intentionally project‑agnostic, pulling structured data while leaving code generation (services, types, models, API clients) to the coding agent.

How to use Yapi Fetch Mcp?

Install globally with npm install -g yapi-fetch-mcp. Configure environment variables YAPI_HOST and either YAPI_TOKEN (project token) or YAPI_COOKIE (browser cookie). Then add the server to your MCP client (e.g., Codex) using npx -y yapi-fetch-mcp or the global command. Authentication can also be passed directly in tool parameters.

Key features of Yapi Fetch Mcp

Retrieve single interface detail by YApi page URL or interface ID.
Read a YApi project’s full interface directory.
Search project interfaces by keyword with pagination.
Supports both project‑token and cookie/session authentication.
Returns normalized request/response metadata; optionally includes raw YApi data.

Use cases of Yapi Fetch Mcp

AI coding agents automatically understanding API endpoints documented in YApi.
Generating TypeScript types, service stubs, or API clients from YApi definitions.
Searching for interfaces by keyword across a YApi project.
Retrieving interface details without manual browsing when building integration tools.

常见问题

How do I get a long‑term token?

The `YAPI_TOKEN` is a project‑level token found in your YApi project’s Settings page (under “Token” or “Project Token”).

What if my YApi uses `Authorization: Bearer` instead of a query‑parameter token?

The current version sends the token only as a query parameter. If your access token must go in the `Authorization` header, use `YAPI_COOKIE` instead, or extend the code for your private YApi.

Can I authenticate with a browser cookie?

Yes. Set the `YAPI_COOKIE` environment variable with the full cookie string (e.g., `_yapi_token=...; _yapi_uid=...`). This works for YApi instances that require login.

What YApi API endpoints does this MCP call?

It uses `/api/interface/get`, `/api/interface/list_menu`, and `/api/interface/list` from the standard YApi API.

Can I run this from source instead of installing the npm package?

Yes. Clone the repository, run `npm install && npm build`, then point your MCP client’s `command` to `node /absolute/path/to/build/src/index.js`.

浏览器自动化分类下的更多 MCP 服务器

Fetch MCP

jae-jae

MCP server for fetch web page content using Playwright headless browser.

1.1K

Open Browser Use

iFurySt

🔮 Platform-neutral Browser Use for AI agents: real Chrome automation with a CLI + SDKs, no lock-in, dead simple.

371

Fetch

modelcontextprotocol

Model Context Protocol Servers

88.1K

Puppeteer MCP Server

merajmehrabi

This MCP server provides browser automation capabilities through Puppeteer, allowing interaction with both new browser instances and existing Chrome windows.

474

Full Self Browsing

Lakshman Turlapati

DOM-first AI browser automation for Chrome and MCP clients.

194