Md To Notion

Markdown到Notion MCP服务器

英语 | 日语

转换的MCP服务器 .md 文件内容并将其输出到Notion。

特性

• 将Markdown文件内容转换为Notion页面格式并输出
• 验证Notion API连接
• 显示当前服务器配置

安装

# Clone the repository
git clone https://github.com/camoneart/markdown-to-notion
cd markdown-to-notion

# Install dependencies
pnpm install

# Build TypeScript
pnpm run build

# Register as global command
pnpm link --global

配置

1. 复制 .env.example 创建 .env 文件
2. 配置Notion API令牌

cp .env.example .env

编辑 .env 文件：

NOTION_API_TOKEN=your_notion_api_token_here

# Optional: Default Notion page ID (enables page ID omission when set)
DEFAULT_NOTION_PAGE_ID=your_default_page_id_here

如何获取Notion API代币

1. 首选 概念开发者
2. 点击“新建集成”
3. 输入集成名称（例如“Markdown MCP服务器”）
4. 选择工作区
5. 点击“提交”
6. 复制显示的令牌

用法

1.作为MCP服务器运行

# Development mode
pnpm run dev

# Production mode (after build)
pnpm start

2.使用Claude Code等MCP客户端

将以下内容添加到MCP客户端配置文件中(.mcp.json):

{
  "mcpServers": {
    "markdown-to-notion": {
      "type": "stdio",
      "command": "md-to-notion",
      "args": [],
      "env": {
        "NOTION_API_TOKEN": "your_notion_api_token_here",
        "DEFAULT_NOTION_PAGE_ID": "your_default_page_id_here"
      }
    }
  }
}

注： 要使用上述配置，您需要将其注册为全局命令 pnpm link --global 事先。

可用工具

md到概念

将Markdown文件内容添加到Notion页面

参数：

• markdownFilePath：markdown文件的路径
• notionPageId：要附加内容的通知页面ID（可选）

使用示例：

# With page ID specified
markdownFilePath: ./example.md
notionPageId: 1234567890abcdef1234567890abcdef

# Using default page ID (simple!)
markdownFilePath: ./example.md
※ DEFAULT_NOTION_PAGE_ID is used when notionPageId is omitted

验证概念连接

验证Notion API连接

参数： 无

可用资源

配置信息

显示当前服务器配置

URI： config://current

发展

# Run tests
pnpm test

# Run linter
pnpm run lint

# Type check
pnpm run typecheck

故障排除

常见错误

1. “需要NOTION_API_TOKEN环境变量”

- 未在中设置Notion API令牌 .env 文件

1. “找不到Markdown文件”

- 指定的Markdown文件路径不正确

1. “检索Notion页面失败”

- 通知页面ID不正确或集成没有访问该页面的权限

权限设置

要向Notion页面添加内容，您需要将创建的集成连接到该页面：

1. 打开目标Notion页面
2. 点击右上角的“⋯”（三点菜单）
3. 从菜单中选择“连接”
4. 在搜索框中输入集成名称
5. 选择显示的集成
6. 在权限确认屏幕上单击“确认”

许可证

根据 MIT许可证.