mcpField
Y
yapi-mcp-server

yapi-mcp-server

本地服务
github.com/zoeminghong开发工具185 周前更新

关于 yapi-mcp-server

一个以 TypeScript 编写的简易文本笔记 MCP 服务,适用于需要创建笔记、以资源方式访问笔记或整理内容以供摘要的客户端。

主要功能

  1. 01创建包含标题和内容的文本笔记
  2. 02通过 note:// URI 列出和读取笔记
  3. 03为笔记附加元数据
  4. 04提供包含笔记内容的摘要提示词

适用场景

  1. 01保存笔记以供后续访问
  2. 02通过 MCP 资源读取笔记内容
  3. 03整理已存笔记以供 LLM 摘要

MCP 相关

向 MCP 客户端提供笔记资源、创建笔记工具和摘要提示词。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

yapi-mcp-service MCP 服务

一个模型上下文协议服务

这是一个基于 TypeScript 的 MCP 服务,实现了一个简单的笔记系统。它通过提供以下功能来展示 MCP 的核心概念:

  • 表示文本笔记的资源,包含 URI 和元数据
  • 用于创建新笔记的工具
  • 用于生成笔记摘要的提示词

功能

资源
  • 通过 note:// URI 列出和访问笔记
  • 每条笔记都包含标题、内容和元数据
  • 使用纯文本 MIME 类型,便于访问内容
工具
  • create_note - 创建新的文本笔记
    • 将标题和内容作为必需参数
    • 将笔记存储在服务状态中
提示词
  • summarize_notes - 生成所有已存储笔记的摘要
    • 将所有笔记内容作为嵌入式资源
    • 返回用于大模型摘要的结构化提示词

开发

安装依赖项:

npm install

构建服务:

npm run build

用于自动重新构建的开发模式:

npm run watch

安装

要与 Claude Desktop 配合使用,请添加服务配置:

MacOS:~/Library/Application Support/Claude/claude_desktop_config.json Windows:%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "yapi-mcp-service": {
      "command": "/path/to/yapi-mcp-service/build/index.js"
    }
  }
}
调试

由于 MCP 服务通过 stdio 通信,调试可能颇具挑战。我们建议使用 MCP Inspector,它可通过包脚本运行:

npm run inspector

Inspector 将提供一个 URL,供你在浏览器中访问调试工具。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。