功能特点
- 基于Node.js和TypeScript开发
- 使用MCP协议(Model Context Protocol)提供服务
- 完整支持Writeathon API的所有功能
- 提供REST API接口和MCP服务接口
安装```bash
1. 克隆仓库
git clone https://github.com/Hcs66/writeathon-mcp.git
cd writeathon-mcp-server
2. 安装nodejs
确保使用Node.js 20+以上版本,若同时存在多个版本,可先安装nvm并切换
安装依赖,确保文件夹有读写权限
npm install
## 配置
1. 复制`.env.example`文件为`.env.prod`
2. 编辑`.env.prod`文件,填入你的Writeathon用户ID、集成Token(web→设置→集成)```
# API配置
API_BASE_URL=https://api.writeathon.cn
WRITEATHON_USER_ID=your_user_id_here
WRITEATHON_TOKEN=your_integration_token_here
# 服务器配置
PORT=3000
HOST=localhost
运行```bash
开发模式运行
npm run dev
或者构建后运行
npm run build
npm start
- 服务器将在`HOST:PORT`上运行。
- MCP服务将在`HOST:PORT+1`上运行。
- MCP SSE地址为`HOST:PORT+1/mcp/sse`。
## 在Claude/Trae等平台使用
通过复制`mcp.json`内容手动创建MCP
其中`HOST`和`PORT`为.env配置文件中的HOST和PORT+1,如HOST=localhost,PORT=3000,则url为`http://localhost:3001/mcp````json
{
"mcpServers": {
"writeathon": {
"type": "streamable-http",
"url": "http://HOST:PORT/mcp",
"note": "For Streamable HTTP connections, add this URL directly in your MCP Client"
}
}
}
API接口
服务器提供以下REST API接口:
GET /api/me- 获取用户信息POST /api/cards- 创建卡片GET /api/cards/recent- 获取最近更新的卡片列表POST /api/cards/get- 获取卡片POST /api/writing-pick- 写作拾贝
MCP服务
服务器提供以下MCP服务:
me- 获取用户信息create_card- 创建卡片recent_cards- 获取最近更新的卡片列表get_card- 获取卡片writing_pick- 写作拾贝
