Agent skill
mcp-builder-jp
Simplified Japanese MCP (Model Context Protocol) server builder skill covering project setup, Japanese API integrations (Chatwork, Backlog, freee, kintone), and development guidelines. Triggers on requests for MCPサーバー構築, MCP開発, MCPツール作成.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/mcp-builder-jp
SKILL.md
MCPサーバー構築支援スキル
概要
MCP(Model Context Protocol)サーバーの設計・構築を支援するスキルです。日本で広く使われるビジネスAPIとの連携を中心に、プロジェクト構成からツール定義までをカバーします。
MCPサーバーの基本構成
MCPサーバーは、LLMが外部ツール・データソースにアクセスするための標準プロトコルです。
クライアント (Claude等) ←→ MCPサーバー ←→ 外部API / データベース
主要な構成要素
| 要素 | 説明 |
|---|---|
| Tools | LLMが呼び出せる関数(API操作、データ取得など) |
| Resources | LLMが読み取れるデータソース(ファイル、DB) |
| Prompts | 再利用可能なプロンプトテンプレート |
日本のAPI連携例
Chatwork API
// チャットワークへのメッセージ送信ツール
server.tool("chatwork_send_message", {
room_id: z.string().describe("ルームID"),
body: z.string().describe("メッセージ本文"),
}, async ({ room_id, body }) => {
const res = await fetch(
`https://api.chatwork.com/v2/rooms/${room_id}/messages`,
{ method: "POST", headers: { "X-ChatWorkToken": TOKEN },
body: new URLSearchParams({ body }) }
);
return { content: [{ type: "text", text: `送信完了: ${res.status}` }] };
});
Backlog API
- 課題の作成・更新・検索
- Wiki ページの取得・編集
- プロジェクト情報の参照
freee会計 API
- 取引の登録・検索
- 勘定科目の取得
- 請求書の作成
kintone API
- レコードの取得・登録・更新
- アプリ情報の参照
- フィールド定義の取得
プロジェクト構成テンプレート
my-mcp-server/
├── src/
│ ├── index.ts # エントリポイント(サーバー起動)
│ ├── tools/ # ツール定義
│ │ ├── chatwork.ts # Chatwork 連携ツール
│ │ └── backlog.ts # Backlog 連携ツール
│ ├── resources/ # リソース定義
│ └── utils/ # ユーティリティ関数
├── package.json
├── tsconfig.json
└── README.md # 日本語ドキュメント
基本的なサーバー初期化
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
const server = new McpServer({
name: "my-mcp-server",
version: "1.0.0",
});
// ツールの登録
// server.tool(...) でツールを追加
const transport = new StdioServerTransport();
await server.connect(transport);
開発ルール
コメント・ドキュメントは日本語で記述
/**
* Chatworkの指定ルームにメッセージを送信する
* @param roomId - 送信先のルームID
* @param message - 送信するメッセージ本文
* @returns 送信結果のステータス
*/
ツール説明文の日本語化
describe()の引数は日本語で記述する- LLMがツールの用途を正しく理解できるよう、具体的に記述する
エラーメッセージの日本語化
- API エラーは日本語で分かりやすく返す
- 例:
"Chatworkへの送信に失敗しました(ステータス: 401 認証エラー)"
参考リンク
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?