writeathon-mcp

Hcs66/writeathon-mcp

3.3

If you are the rightful owner of writeathon-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Writeathon MCP 服务器是一个基于MCP协议的API服务器,提供与Writeathon平台的集成服务。

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

配置

  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

运行

# 开发模式运行
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

其中HOSTPORT为.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