MCP Servers

MCP サーバー

JIRA や TODO 管理など、さまざまなサービスとの連携ツールを提供する、Model Context Protocol（MCP）の TypeScript ベースのサーバー実装です。

🚀 特長

• 複数のツール連携：複数のツール連携に対応したモジュール式アーキテクチャ
• 型安全性：Zod スキーマ検証を備えた完全な TypeScript サポート
• ESM サポート：最新の ES Modules 実装
• 拡張性：新しいツールや連携を簡単に追加できます

📦 現在のツール

JIRA 連携

• カスタマイズ可能なフィールドを指定して課題を作成
• レスポンスを自動でフォーマット
• 課題作成時のスキーマ検証

TODO 管理

• 優先度と期限を指定して TODO を作成
• オプションフィールドに対応した柔軟なスキーマ
• フォーマット済みのレスポンスメッセージ

🛠 プロジェクト構成

src/
├── config/           # Tool configurations
│   ├── jira-tool.config.ts
│   └── todo-tool.config.ts
├── constant/         # Constant definitions
│   └── tool-name.ts
├── schema/          # Zod schemas for validation
│   ├── jira.ts
│   └── todo.ts
├── server/          # Server management
│   └── mcp-server-tool-manager.ts
├── tools/           # Tool implementations
│   ├── jira/
│   │   └── create-issue.ts
│   └── todo/
│       └── create-todo.ts
└── index.ts         # Main entry point

🔌 新しいツールの追加

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

例：

// 1. Add constant
export const NEW_TOOL = {
  ACTION: "action_name"
} as const;

// 2. Create schema
export const newToolSchema = z.object({
  // ... schema definition
});

// 3. Implement handler
export const handleAction = async (
  args: z.infer<typeof newToolSchema>,
  extra: RequestHandlerExtra
): Promise<CallToolResult> => {
  // ... implementation
};

// 4. Add configuration
export const newToolConfig = {
  name: "New Tool",
  version: "1.0.0",
  tools: [
    {
      name: NEW_TOOL.ACTION,
      schema: newToolSchema,
      handler: handleAction,
    },
  ],
};

🔄 開発ワークフロー

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

📝 注意事項

• モジュール性を高めるため、ES Modules を使用しています
• 標準化された通信のために Model Context Protocol を実装しています
• TypeScript のベストプラクティスに従っています
• 型安全性のために Zod スキーマ検証を行います

🛣️ ロードマップ

• JIRA の操作をさらに追加
• TODO の永続化を実装
• 認証を追加
• テストフレームワークを追加
• 連携先をさらに追加（GitHub、Slack など）

📄 ライセンス

MIT