Modular Tool Framework (Jira & Todo)

🚀 MCP サーバー

これは TypeScript をベースにした Model Context Protocol (MCP) サーバーの実装で、JIRA やタスク管理など、様々なサービスを統合するツールを提供します。

🚀 クイックスタート

この MCP サーバーは、TypeScript を用いて開発された、多様なツールを統合するためのサーバーです。多くの便利な機能を備え、開発者に柔軟性と拡張性を提供します。

✨ 主な機能

• 多ツール統合：モジュール化されたアーキテクチャにより、様々なツールの統合をサポートします。
• 型安全：全面的な TypeScript のサポートと Zod スキーマ検証により、型安全を保証します。
• ESM サポート：最新の ES モジュールを使用した実装です。
• 拡張性：新しいツールや統合を簡単に追加することができます。

📦 現在のツール

JIRA 統合

• カスタムフィールドを使用した問題の作成
• 自動応答のフォーマット
• 問題作成のスキーマ検証

タスク管理

• 優先度と期限付きのタスクの作成
• オプションフィールドをサポートする柔軟なスキーマ
• フォーマットされた応答メッセージ

🛠 プロジェクト構造

src/
├── config/           # ツール設定
│   ├── jira-tool.config.ts
│   └── todo-tool.config.ts
├── constant/         # 定数定義
│   └── tool-name.ts
├── schema/          # Zod スキーマ検証
│   ├── jira.ts
│   └── todo.ts
├── server/          # サーバー管理
│   └── mcp-server-tool-manager.ts
├── tools/           # ツール実装
│   ├── jira/
│   │   └── create-issue.ts
│   └── todo/
│       └── create-todo.ts
└── index.ts         # メインエントリーポイント

🔌 新しいツールの追加

1. constant/tool-name.ts でツールの定数を定義します。
2. schema/ ディレクトリにスキーマを作成します。
3. tools/ ディレクトリにツールのハンドラーを実装します。
4. config/ ディレクトリに設定を追加します。
5. index.ts でツールを登録します。

基本的な使用法

// 1. 定数を追加
export const 新工具 = {
  ACTION: "action_name"
} as const;

// 2. スキーマを作成
export const newToolSchema = z.object({
  // ... スキーマ定義
});

// 3. ハンドラーを実装
export const handleAction = async (
  args: z.infer<typeof newToolSchema>,
  extra: RequestHandlerExtra
): Promise<CallToolResult> => {
  // ... 実装ロジック
};

// 4. 設定を追加
export const newToolConfig = {
  name: "新工具",
  version: "1.0.0",
  tools: [
    {
      name: 新工具.ACTION,
      schema: newToolSchema,
      handler: handleAction,
    },
  ],
};

🔄 開発ワークフロー

1. 機能ブランチを作成します。
2. 変更を実施します。
3. テストを実行します（実装されている場合）。
4. プロジェクトをビルドします。
5. PR を提出します。

📝 備考

• より良いモジュール化のために ES モジュールを使用します。
• 標準化された通信を実現するために Model Context Protocol を実装します。
• TypeScript のベストプラクティスに従います。
• 型安全を確保するために Zod スキーマ検証を使用します。

🛣️ ロードマップ

• [ ] より多くの JIRA 操作を追加する
• [ ] タスクの永続化を実装する
• [ ] 認証を追加する
• [ ] テストフレームワークを追加する
• [ ] より多くの統合（GitHub、Slack など）を追加する

📄 ライセンス

MIT