Writeathon Mcp
What is Writeathon Mcp
Writeathon-MCP is a Writeathon API server based on the MCP protocol, providing integrated MCP services for the Writeathon platform.
Use cases
Use cases for Writeathon-MCP include retrieving user information, creating and managing writing cards, accessing recent updates, and facilitating collaborative writing efforts.
How to use
To use Writeathon-MCP, ensure you have Node.js 20 installed, install dependencies using ‘npm install’, configure your environment by copying ‘.env.example’ to ‘.env’ and filling in your Writeathon user ID, integration token, and MCP API key. You can then run the server in development mode with ‘npm run dev’ or build and start it with ‘npm start’.
Key features
Key features include development with Node.js and TypeScript, full support for all Writeathon API functionalities, and the provision of both REST API and MCP service interfaces.
Where to use
Writeathon-MCP can be used in various fields such as content creation, collaborative writing, and educational platforms that require integration with the Writeathon service.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Writeathon Mcp
Writeathon-MCP is a Writeathon API server based on the MCP protocol, providing integrated MCP services for the Writeathon platform.
Use cases
Use cases for Writeathon-MCP include retrieving user information, creating and managing writing cards, accessing recent updates, and facilitating collaborative writing efforts.
How to use
To use Writeathon-MCP, ensure you have Node.js 20 installed, install dependencies using ‘npm install’, configure your environment by copying ‘.env.example’ to ‘.env’ and filling in your Writeathon user ID, integration token, and MCP API key. You can then run the server in development mode with ‘npm run dev’ or build and start it with ‘npm start’.
Key features
Key features include development with Node.js and TypeScript, full support for all Writeathon API functionalities, and the provision of both REST API and MCP service interfaces.
Where to use
Writeathon-MCP can be used in various fields such as content creation, collaborative writing, and educational platforms that require integration with the Writeathon service.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
Writeathon MCP 服务器
这是一个基于MCP协议的Writeathon API服务器，提供了与Writeathon平台集成的MCP服务。
功能特点
- 基于Node.js和TypeScript开发
- 使用MCP协议（Model Context Protocol）提供服务
- 完整支持Writeathon API的所有功能
- 提供REST API接口和MCP服务接口
安装
# 1. 克隆仓库
git clone https://github.com/Hcs66/writeathon-mcp.git
cd writeathon-mcp-server
# 2. 安装nodejs
# 确保使用Node.js 20+以上版本，若同时存在多个版本，可先安装nvm并切换
# 安装依赖，确保文件夹有读写权限
npm install
配置
- 复制
.env.example文件为.env.prod - 编辑
.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
运行
# 开发模式运行
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
{
"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- 写作拾贝
许可证
ISC
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
