Writeathon MCP Server

Writeathon MCP サーバー

これはMCPプロトコルに基づくWriteathon APIサーバーで、Writeathonプラットフォームと連携するMCPサービスを提供します。

特長

• Node.jsとTypeScriptを使用して開発されています
• MCPプロトコル（Model Context Protocol）を使用してサービスを提供します
• REST APIインターフェースとMCPサービスインターフェースを提供します

インストール

# 1. 克隆仓库
git clone https://github.com/Hcs66/writeathon-mcp.git
cd writeathon-mcp

# 2. 安装nodejs
# 确保使用Node.js 20+以上版本，若同时存在多个版本，可先安装nvm并切换

# 安装依赖，确保文件夹有读写权限
npm install

設定

1. 開発モード：.env.exampleファイルを.env.devとしてコピーします
2. 本番モード：.env.exampleファイルを.env.prodとしてコピーします
3. 対応する環境ファイルを編集し、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 Streamable HTTPのアドレスはHOST:PORT+1/mcpです。
• MCPヘルスチェックのアドレスはHOST:PORT+1/mcp/healthです。

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 - カードを作成（space、attachments、shareStatusをサポート）
• POST /api/cards/extend - カードを拡張（attachmentsをサポート）
• GET /api/cards/recent - 最近更新されたカードの一覧を取得（space、exclude_date_titleをサポート）
• POST /api/cards/get - カードを取得
• POST /api/cards/search - カードを検索（space、sortString、limitをサポート）
• GET /api/spaces - スペースの一覧を取得
• POST /api/writing-pick - ライティングピック

MCPサービス

サーバーは以下のMCP機能を提供します。

• リソース
  • user://me - ユーザー情報を取得
  • recent-cards://list?exclude_date_title={exclude_date_title}&space={space} - 最近のカード一覧
  • cards://{id} - カードを取得
  • writing-pick://{type}?limit={limit} - ライティングピック
  • spaces://list - スペース一覧
• ツール
  • create-card - カードを作成（space、attachments、shareStatusをサポート）
  • extend-card - カードを拡張（attachmentsをサポート）
  • get-card - カードを取得
  • get-recent-cards - 最近更新されたカードの一覧を取得（space、exclude_date_titleをサポート）
  • search-cards - カードを検索
  • list-spaces - スペースの一覧を取得
  • get-writing-pick - ライティングピック
• プロンプト
  • create-card-prompt - 内容に基づいてカードを作成
  • writing-pick-prompt - ライティングピックを取得

ライセンス

ISC