Skip to main content
Glama
ASTLY123

txt-to-md-mcp

by ASTLY123

TXT to MD MCP 服务器

这是一个基于 FastMCP 的简单工具,用于将文本内容写入到 Markdown 文档。

PS:起因是vscode只能保存一定的量的历史,而且各项目之间历史也不互通,有些历史记录感觉有必要保存以下。看一些其他的memory mcp,感觉工具太多了没什么必要,所以弄个简单的就是为了存个对话历史。

功能特性

  • 📝 将文本内容转换为 Markdown 格式并保存

  • 📂 支持子文件夹组织

  • 🔒 支持文件覆盖控制

  • 📋 列出最近修改的 Markdown 文件

  • 🚀 支持通过 stdio 方式启动

  • ⚙️ 启动时指定存储路径

Related MCP server: MCP Notes Server

安装依赖

pip install fastmcp

使用方法

1. 直接运行服务器

# 使用默认路径
python server.py

# 指定存储路径
python server.py "d:\my-notes"

2. 在 VS Code 中配置

Claude Desktop 配置

在 Claude Desktop 的配置文件中添加:

{
  "mcpServers": {
    "txt-to-md-converter": {
      "command": "python",
      "args": [
        "d:\\obsidian_storage\\default\\mcp\\txt-to-md-mcp\\server.py",
        "d:\\obsidian_storage\\default"
      ],
      "env": {}
    }
  }
}

VS Code 扩展配置

在 VS Code 的 settings.json 中添加:

{
  "mcp.servers": [
    {
      "name": "txt-to-md-converter",
      "command": "python",
      "args": [
        "d:\\obsidian_storage\\default\\mcp\\txt-to-md-mcp\\server.py",
        "d:\\obsidian_storage\\default"
      ],
      "cwd": "d:\\obsidian_storage\\default\\mcp\\txt-to-md-mcp"
    }
  ]
}

3. 使用工具

write_txt_to_markdown

将文本内容写入 Markdown 文件:

# 基本使用
{
    "content": "这是文本内容\\n\\n支持多行文本",
    "filename": "my-note"  # 会自动添加 .md 扩展名
}

# 高级使用
{
    "content": "## 会议记录\\n\\n- 讨论项目进度",
    "filename": "meeting_notes",
    "title": "每周会议记录",
    "subfolder": "work",  # 存储到 work 子文件夹
    "overwrite": true     # 覆盖已存在文件
}

list_recent_md_files

列出最近修改的 Markdown 文件:

{
    "limit": 10,          # 返回文件数量限制
    "subfolder": "work"   # 可选:指定子文件夹
}

stdio 启动方式说明

MCP 通过 stdio (标准输入/输出) 方式启动,实现与客户端的通信:

工作原理

  1. 进程启动: 客户端启动 MCP 服务器进程,传递存储路径参数

  2. 通信管道: 通过 stdin/stdout 进行 JSON-RPC 通信

  3. 协议交互: 初始化 → 工具注册 → 工具调用

启动参数

服务器接受一个可选的命令行参数作为存储路径:

python server.py [存储路径]
  • 如果不提供参数,默认使用 d:/obsidian_storage/default

  • 如果目录不存在,会自动创建

在不同客户端中的配置

  1. Claude Desktop: 在 args 数组中添加存储路径

  2. VS Code 扩展: 在配置的 args 中指定路径

  3. 自定义客户端: 启动进程时传递路径参数

测试

运行测试脚本验证功能:

python test_server.py

测试脚本会:

  • 启动服务器(传递测试路径)

  • 发送初始化请求

  • 调用文件写入工具

  • 验证结果

示例

快速笔记

{
    "content": "今天学习了 MCP 协议\\n\\n- 支持 stdio 通信\\n- 使用 JSON-RPC",
    "filename": "mcp-learning"
}

项目文档

{
    "content": "# 项目计划\\n\\n## 第一阶段\\n- 需求分析\\n- 架构设计",
    "filename": "project-plan",
    "title": "项目开发计划",
    "subfolder": "projects"
}

许可证

MIT License

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to list, search, read, and append to Markdown notes through MCP tool calls, making it easy to interact with a second brain folder.
    -
  • A
    license
    A
    quality
    C
    maintenance
    Enables AI assistants to interact with a local folder of Markdown notes, supporting listing, reading, searching, creating, and appending to notes with strict security boundaries.
    5
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables passing notes between Claude rooms on the same machine via Markdown files. Supports listing, reading, and writing notes with security validation.
    MIT
  • F
    license
    Not graded
    quality
    B
    maintenance
    Enables managing local Markdown notes by creating, viewing, listing, and searching notes and their contents through MCP tools.
    -