Back to Directory/Developer Tools

io.github.huandu/feishu-markdown-mcp

MCP server for Feishu Markdown

Developer ToolsTypeScriptv0.1.3

Feishu Markdown

Build license

本项目是一个单仓库(monorepo),用于将 Markdown 转换为飞书 / Lark 文档格式,并提供一个 MCP 服务以便与 Model Context Protocol 集成。

主要 package:

  • feishu-markdown:核心库,将 Markdown 转换为飞书文档结构,支持图片、流程图(Mermaid)等处理。
  • feishu-markdown-mcp:基于 feishu-markdown 的 MCP 服务,可作为模型上下文协议(Model Context Protocol)的后端插件使用。

快速开始

  1. 安装依赖:
pnpm install
  1. 构建所有包:
pnpm build
  1. 在开发中运行某个包(示例):
pnpm --filter feishu-markdown dev

开发

  • 运行全部测试:pnpm test
  • 代码风格与类型检查:pnpm lint / pnpm typecheck

发布

仓库提供了 GitHub Actions 工作流用于自动发布。发布到 npm 公共仓库需要在仓库 Secrets 中配置 NPM_TOKEN(用于 pnpm publish)。

许可证

本项目使用 MIT 许可证,详见项目根目录的 LICENSE 文件。


更多信息请查看各子包的 package.json 与 README.md。

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y feishu-markdown-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-huandu-feishu-markdown-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "feishu-markdown-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

feishu-markdown-mcpnpm

Compatible MCP Clients

io.github.huandu/feishu-markdown-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More