Contributing Guide

Required

• mise

リポジトリのセットアップ

git clone git@github.com:kintone/mcp-server.git
cd mcp-server
mise install
pnpm install

MCPサーバー起動

pnpm dev

ビルド

npmパッケージ

pnpm build

Dockerコンテナイメージ

docker build -f ./docker/Dockerfile .

PRから検証用イメージを ghcr.io に publish する場合は docs/dev/snapshot-publish.md を参照してください。

MCPBファイル

pnpm build:mcpb

テスト

pnpm test

コミットメッセージとPRの規約

コミットメッセージ

Conventional Commitsに従ってください。

フォーマット: <type>: <description>

サポートされているコミットタイプ

Type	説明
feat	新機能
fix	バグ修正
test	テストの更新
build	ビルドプロセスの変更
ci	CIワークフローの変更
docs	ドキュメントの更新
perf	パフォーマンスの改善
refactor	リファクタリング
revert	過去の変更の取り消し
lint	Lintの更新
style	スタイルの更新
debug	デバッグ
chore	その他の変更

破壊的変更

破壊的変更がある場合：

• スコープの後に!を追加する
• フッターにBREAKING CHANGE: <description>を含める

プルリクエスト（PR）タイトル

PRタイトルもコミットメッセージと同様にConventional Commitsの形式に従ってください。

Conventional Commitsをもとに release-pleaseによってリリース時に適切なバージョン番号が自動的に決定され、CHANGELOGが自動生成されます。

バージョニング

Semantic Versioningに従います。