🤖 Model Context Protocol (MCP) Examples

🤖 Model Context Protocol (MCP) のサンプル

このリポジトリには、Model Context Protocol TypeScript SDK を使用して構築された、モジュール式の MCP エージェントサーバーが含まれています。
src/ 内の各サブディレクトリは、ツールとプロンプトを備えた自己完結型の MCP サーバーです（コード分析、要約など）。

✨ ルートの src/index.ts が、個々のサーバーを動的に登録して起動します。

---

📦 構成

src/
├── index.ts         # Main launcher to register all MCP servers
├── code-analysis/   # Analyzes local code repositories
│   ├── tools.ts     # Tool implementations
│   ├── server.ts    # Registers tools & prompts with MCP
│   ├── utils.ts     # Helper functions (file reading, structure)
│   ├── prompt.ts    # Prompt handler definitions
│   └── README.md    # Module-specific usage docs
...

---

🚀 はじめに

1. 依存関係をインストールする

npm install

2. （任意）ローカルの .env を設定する

echo "PORT=3000" > .env

3. MCP サーバーを起動する

npm run dev

サーバーは次のアドレスで実行されます： http://localhost:3000/mcp

---

🧪 デバッグ／手動テスト

MCP ベースのサーバー向け UI デバッガーである MCP Inspector を使って、サーバーをテストできます。

MCP Inspector を起動する（別のターミナルで）

npm run debug

次に、以下を開きます： 👉 http://127.0.0.1:6274 Streamable HTTP を使用して http://localhost:3000/mcp に接続します。

---

🧩 対応している MCP モジュール

フォルダー	説明	トランスポート
code-analysis	ローカルのコードリポジトリを分析して調査する	Streamable HTTP
boilerplate-gen	スターターコードベースを生成し、機能を段階的に追加する	STDIO
(近日公開予定)	...	...

---

📜 ライセンス

MIT License Copyright (c) 2025 suresh konakanchi

Permission is hereby granted,
free of charge, to any person obtaining a copy of this software and associated
documentation files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use, copy, modify, merge,
publish, distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to the
following conditions:

The above copyright notice and this permission notice
(including the next paragraph) shall be included in all copies or substantial
portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.