Slima MCP

小説家向けAI執筆IDE Slima のMCP（Model Context Protocol）サーバー。

Slimaの書籍をあらゆるMCP互換AIツールに接続 — 1つのサーバーですべてのプラットフォームに対応。

対応プラットフォーム

デスクトップアプリケーション（ローカルMCP - stdio）

Webアプリケーション（リモートMCP - HTTP）

MCPは2025年12月、Anthropic、OpenAI、BlockがLinux Foundation傘下にAgentic AI Foundationを共同設立したことにより、業界標準となりました。

Related MCP server: scrumdo-mcp

機能

書籍管理

• 作成 新しい書籍

• 書籍の一覧表示と表示

• ファイル/フォルダ構造の取得

• 執筆統計の追跡

ファイル操作

• 読み取り 任意のファイルをパス指定で

• 編集 特定のテキスト（検索＆置換）

• 書き込み（置換）ファイル内容

• 作成 新しいファイル

• 削除 ファイル

• 追加 ファイルへの内容追加

• 検索 全ファイル横断

AIベータリーダー

• 仮想リーダーペルソナからのフィードバック取得

• 異なるリーダーの視点で章を分析

クイックスタート

AIの使い方に合わせてパスを選んでください：

• ⭐ claude.ai / ChatGPT（Webブラウザ） をご利用の場合 → 推奨：Webコネクタ (一度設定すれば、自動で永久に更新)

• Claude Desktop / Cursor / Gemini CLI（ローカル） をご利用の場合 → ローカルインストール（npx）

• エアギャップ環境/エンタープライズ環境で実行する場合 → セルフホスト

推奨：claude.ai / ChatGPT Web（自動更新）

ブラウザでClaudeやChatGPTとチャットする場合、これが最も簡単で将来性のあるオプションです。一度設定すれば、Slima MCPのアップデートを自動で受け取れます — アップグレードコマンドや設定編集は不要です。

MCP URL: https://mcp.slima.ai/mcp

claude.ai（Pro / Max / Team / Enterprise）

1. claude.ai にサインインします。

2. 設定 → コネクタ（またはプランに応じて統合）を開きます。

3. カスタムコネクタを追加をクリックします。

4. 次の項目を入力します：

   • 名前: Slima

   • URL: https://mcp.slima.ai/mcp

5. 接続をクリック → slima.aiにリダイレクトされ承認 → claude.aiに戻ります。

6. チャット入力欄にSlimaツールアイコンが表示されます。完了です。

ChatGPT（Plus / Pro、デベロッパーモード）

1. chatgpt.com にサインインします。

2. 設定 → コネクタ → 詳細設定を開き、デベロッパーモードをオンにします（2025.10+）。

3. コネクタに戻り、作成 → カスタムMCPサーバーをクリックします。

4. 次の項目を入力します：

   • 名前: Slima

   • サーバーURL: https://mcp.slima.ai/mcp

   • 認証: OAuth

5. 作成をクリック → OAuthフローを承認します。

設定後、次の会話からSlimaの機能が自動的に利用可能になります。再起動や再インストールは不要です。

ローカル：Claude Desktop / Cursor / Gemini CLI

オフラインでの操作、より高速な起動、または他のstdioサーバーと一緒にMCPを実行する必要がある場合に使用します。

推奨設定 — メジャーバージョンに固定されるため、新機能は自動的に取得されますが、1.0リリースで壊れることはありません：

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または%APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します：

{
  "mcpServers": {
    "slima": {
      "command": "npx",
      "args": ["-y", "slima-mcp@0"],
      "env": {
        "SLIMA_API_TOKEN": "slima_your_token_here"
      }
    }
  }
}

トークンはSlima設定から取得するか、npx slima-mcp@0 authを一度実行してディスクに保存します。

Cursor

{
  "mcpServers": {
    "slima": {
      "command": "npx",
      "args": ["-y", "slima-mcp@0"],
      "env": {
        "SLIMA_API_TOKEN": "slima_your_token_here"
      }
    }
  }
}

Gemini CLI

gemini mcp add slima --command "npx -y slima-mcp@0"

slima-mcp / slima-mcp@latest ではなく slima-mcp@0 を使う理由は？ @0 を使用すると現在のメジャーバージョンに固定されます — npxは新しい 0.x.y リリースを自動的に取得します（機能とバグ修正を取得できます）が、破壊的変更を含む 1.0.0 をリリースした場合、設定を更新しない限り自動的に適用されることはありません。@1 への切り替えはリリースノートでお知らせします。

グローバルインストールからの移行

すでに npm install -g slima-mcp でグローバルインストールしている場合：

# Remove the old global install (optional but cleaner)
npm uninstall -g slima-mcp

# Change your config `command` from "slima-mcp" to the npx form above, and restart the client.

または、グローバルインストールを継続する場合は、定期的に以下を実行してください：

npm install -g slima-mcp@latest

そうしないと、ローカルクライアントがSlimaバックエンドが公開するMCPツール/スキーマから乖離します。

セルフホスト（上級者向け）

このリポジトリをクローンして、Cloudflare Workerを自分でデプロイすることもできます。wrangler.toml + npm run deploy:worker を参照してください。通常の使用には必要ありません。

リモートMCPのセキュリティ

https://mcp.slima.ai/mcp でホストされているリモートMCPサーバーは以下を使用します：

• OAuth 2.0 + PKCE による認証 — トークンのコピー＆ペーストは不要。

• サーバー側にシークレットを保存しない — 認証情報がSlimaの認証サーバーから流出することはありません。

• セッションベース: OAuthトークンはCloudflare KVに保存され、セッションごとにスコープが設定されます。

• いつでも取り消し可能 Slima設定から。

書籍タイプ：Writing Studio vs Script Studio

Slimaの書籍には2つの種類があり、book_type フィールドで区別されます。MCPの動作はそれぞれで少し異なります：

書籍ごとの詳細については、AIクライアントにリソース slima://books/{book_token}/schema を読み取るよう依頼してください — その特定の書籍に対して書き込み可能/読み取り専用のパスが正確に記述されたJSON仕様が返されます。

list_books はすべての書籍にスタジオアイコン（📝 / 📖）をタグ付けするため、あなた（とAI）が一目で区別できます。

利用可能なツール

書籍管理

ファイル操作

AIベータリーダー

使用例

設定後、AIに次のように依頼できます：

書籍とコンテンツ：

• 「『マイノベル』という新しい本を作成して」

• 「Slimaの本を一覧表示して」

• 「小説の構造を見せて」

• 「本の第3章を読んで」

• 「執筆統計は？」

ファイル操作：

• 「主人公のキャラクタープロフィールを読んで」

• 「第1章を編集して、'John'を'James'に変更して」

• 「worldbuilding.mdという新しいファイルを作成して、魔法システムについてのメモを追加して」

• 「本の中で'青い目'への言及をすべて検索して」

• 「この新しい段落を第5章に追加して」

AIフィードバック：

• 「第5章について、若い読者の視点からフィードバックを得たい」

• 「冒頭のシーンを批評家の視点から分析して」

CLIコマンド

slima-mcp auth      # Authenticate with browser (recommended)
slima-mcp status    # Check authentication status
slima-mcp logout    # Remove saved credentials
slima-mcp --help    # Show help
slima-mcp --version # Show version

トークンは安全なパーミッションで ~/.slima/credentials.json に保存されます。

環境変数

* slima-mcp auth を使用した場合は不要

開発

ローカルCLI開発

# Clone the repository
git clone https://github.com/slima-ai/slima-mcp.git
cd slima-mcp

# Install dependencies
npm install

# Build CLI
npm run build

# Run tests
npm test

# Run in development mode
npm run dev

Cloudflare Worker開発

# Build the Worker
npm run build:worker

# Run Worker locally
npm run dev:worker

# Deploy to Cloudflare
npm run deploy:worker

# Deploy to preview environment
npm run deploy:worker:preview

プロジェクト構造

slima-mcp/
├── src/
│   ├── core/           # Shared core modules
│   │   ├── api/        # Slima API Client
│   │   ├── tools/      # MCP Tool implementations
│   │   └── utils/      # Utilities and errors
│   ├── cli/            # CLI entry point (stdio transport)
│   │   ├── index.ts    # CLI main
│   │   ├── auth.ts     # Authentication commands
│   │   └── server.ts   # MCP Server for CLI
│   └── worker/         # Cloudflare Worker (HTTP transport)
│       ├── index.ts    # Worker entry point
│       └── oauth.ts    # OAuth 2.0 + PKCE client
├── wrangler.toml       # Cloudflare Worker config
├── tsup.config.ts      # CLI build config
└── tsup.worker.config.ts # Worker build config

セキュリティ

• APIトークンはローカルに保存され、共有されることはありません

• Slima APIとの通信はすべてHTTPSを使用します

• トークンはいつでもSlima設定から取り消すことができます

リリースとデプロイ

npm（自動）

package.json のバージョンを上げて main にマージすると、GitHub Actionsを介して自動的にnpm公開がトリガーされます。

# 1. Bump version on dev branch
npm version patch   # 0.1.10 → 0.1.11

# 2. Merge to main
git checkout main && git merge dev && git push

# 3. CI runs tests → publish.yml publishes to npm + creates git tag

Cloudflare Worker（手動）

Workerのデプロイはnpmとは別です。コード変更後にデプロイします：

npm run deploy:worker           # Production (mcp.slima.ai)
npm run deploy:worker:preview   # Staging

MCPレジストリ（手動）

MCPレジストリ にサーバーリストを公開/更新するには：

mcp-publisher login github
mcp-publisher publish

リポジトリルートに package.json 内の mcpName と server.json が必要です。

運用上の注意

Worker OAuthのデバッグ

claude.aiやChatGPTのコネクタの問題をトラブルシューティングする場合：

# Live logs from production Worker
wrangler tail slima-mcp

すべてのOAuthエンドポイントは、フローの追跡を支援するために主要なパラメータ（client_id、redirect_uri、トークンプレフィックスなど）をログに記録します。

Worker OAuthフロー（claude.ai / ChatGPT）

Client POST /mcp → 401 + WWW-Authenticate header
  → Client GET /.well-known/oauth-protected-resource
  → Client GET /.well-known/oauth-authorization-server
  → Client POST /register (DCR)
  → Client redirects user to GET /authorize
    → Worker redirects to Rails OAuth
    → User authorizes → Rails redirects to Worker /callback
    → Worker issues auth code → redirects to client callback
  → Client POST /token (exchange code for access_token)
  → Client POST /mcp (Authorization: Bearer {access_token})

既知の制約

• Worker Bearer トークンの検証では、すべての非空トークンを受け入れます（slima_ プレフィックスだけでなく）。これにより、OAuth で発行されたトークンをサポートします。Rails API が実際の検証を実行します。

• getTokenFromSession() は最初に Authorization ヘッダーをチェックし、次に Cookie セッションにフォールバックします。

• MCP Inspector（npx @modelcontextprotocol/inspector）は、OAuth フロー全体を個別にテストするのに便利です。

ライセンス

MIT

リンク

• Slima ウェブサイト

• Slima アプリ

• MCP ドキュメント

• MCP レジストリ

• 問題を報告