🤖 Model Context Protocol (MCP) Examples

🤖 Model Context Protocol（MCP）示例

此仓库包含使用 Model Context Protocol TypeScript SDK 构建的模块化 MCP Agent 服务。
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 Inspector 测试服务，它是用于调试基于 MCP 的服务的 UI 工具。

启动 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.