chouseisan-mcp

chouseisan-mcp

MCP server to read and write events on chouseisan.com (Chouseisan), a Japanese scheduling tool, using unofficial HTTP protocol. Enables creating events, fetching schedules, and managing responses via AI agents or CLI.

Category
Visit Server

README

chouseisan-mcp

調整さん（chouseisan.com）をAIエージェントやCLIから読み書きする、ローカルMCPサーバーです。

できること

MCPツール 用途
chouseisan_create_event イベントを作成
chouseisan_get_event イベントと出欠表を取得
chouseisan_add_response 新しい回答を登録
chouseisan_update_response 名前が完全一致する回答を更新
chouseisan_delete_response 名前が完全一致する回答を削除

注意事項

調整さんには公式APIがないため、このツールはWebサイトで使われている非公式HTTPプロトコルを直接利用します。調整さん側のHTMLや通信仕様が変わると動作しなくなる可能性があります。イベント作成・回答登録・回答更新・回答削除は実データに影響するため、実行対象を確認してから使用してください。

セットアップ

Node.js 18以降が必要です。

git clone https://github.com/soyalumno/chouseisan-mcp.git
cd chouseisan-mcp
npm install

Claude Code

グローバル設定（~/.claude.json）の mcpServers に追加すると、全プロジェクトで使えます。

{
  "mcpServers": {
    "chouseisan": {
      "type": "stdio",
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/chouseisan-mcp/src/mcp_server.ts"],
      "env": {}
    }
  }
}

特定プロジェクトだけで使う場合は、そのプロジェクトの .mcp.json に同じ内容を書きます。

設定後、新しいClaude Codeセッションを開始すると chouseisan_* ツールが利用可能になります。

Codex

~/.codex/config.toml の [mcp] セクションに追加します。

[mcp.chouseisan]
type = "stdio"
command = "npx"
args = ["tsx", "/absolute/path/to/chouseisan-mcp/src/mcp_server.ts"]

CLI

# イベント作成
npx tsx src/cli.ts create --title "懇親会" --memo "候補日を選んでください" --dates "7/25(土) 19:00〜,7/26(日) 19:00〜"

# イベント取得（テキスト表）
npx tsx src/cli.ts get "https://chouseisan.com/s?h=<hash>"

# イベント取得（JSON）
npx tsx src/cli.ts get "<hash>" --json

# 回答登録
npx tsx src/cli.ts respond "<hash>" --name "山田" --marks "○,×" --comment "25日希望です"

# 回答更新（省略した項目は既存値を維持）
npx tsx src/cli.ts update "<hash>" --name "山田" --marks "△,○"
npx tsx src/cli.ts update "<hash>" --name "山田" --comment "予定が変わりました"

# 回答削除
npx tsx src/cli.ts delete "<hash>" --name "山田"

入力できる出欠記号は ○（◯ / o / O / 1）、△（2）、×（x / X / 3）、-（0 / 空文字）です。

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured