Markdown到Notion MCP服务器
英语 | 日语
转换的MCP服务器 .md 文件内容并将其输出到Notion。
特性
- 将Markdown文件内容转换为Notion页面格式并输出
- 验证Notion API连接
- 显示当前服务器配置
安装```bash
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` 文件
1. 配置Notion API令牌```bash
cp .env.example .env
编辑 .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. 首选 概念开发者
1. 点击“新建集成”
1. 输入集成名称(例如“Markdown MCP服务器”)
1. 选择工作区
1. 点击“提交”
1. 复制显示的令牌
## 用法
### 1.作为MCP服务器运行```bash
# Development mode
pnpm run dev
# Production mode (after build)
pnpm start
2.使用Claude Code等MCP客户端
将以下内容添加到MCP客户端配置文件中(.mcp.json):```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
发展```bash
Run tests
pnpm test
Run linter
pnpm run lint
Type check
pnpm run typecheck
```
故障排除
常见错误
- “需要NOTION_API_TOKEN环境变量”
- 未在中设置Notion API令牌
.env文件
- “找不到Markdown文件”
- 指定的Markdown文件路径不正确
- “检索Notion页面失败”
- 通知页面ID不正确或集成没有访问该页面的权限
权限设置
要向Notion页面添加内容,您需要将创建的集成连接到该页面:
- 打开目标Notion页面
- 点击右上角的“⋯”(三点菜单)
- 从菜单中选择“连接”
- 在搜索框中输入集成名称
- 选择显示的集成
- 在权限确认屏幕上单击“确认”
许可证
根据 MIT许可证.
