🚀 MCP Server DDD 模板

此仓库是一个使用 Node.js/TypeScript 实现的 Model Context Protocol (MCP) 服务器模板，旨在通过领域驱动设计（DDD）原则展示一个干净、分层的架构。它提供了通过外部API获取与比特币相关信息的工具。

✨ 主要特性

• 🏗️ 模板项目： 此代码库作为结构化MCP服务器的参考模板，采用DDD原则，准备好进行定制和生产使用。
• 🔌 MCP协议： 使用MCP协议（@modelcontextprotocol/sdk）通过_stdio_进行通信。
• 🏛️ 分层DDD架构： 域模型、应用逻辑、基础设施和服务接口层之间有明确的分离。
• ⚡ TypeScript： 使用现代TypeScript完全类型化，以提供更好的开发体验。

📁 项目结构

src/
├── domain/                  # 🏛️ 域模型和响应接口
│   └── models/
│       └── responses/
│           ├── ** 接口响应 **
├── infrastructure/          # 🔌 外部API客户端和服务请求
│   ├── interfaces/
│   │   └── IApiClient.ts
│   └── services/
│       ├── clients/
│       │   └── ** 客户端API **
│       └── requests/
│           ├── ** 请求服务 **
├── application/             # ⚙️ 业务逻辑和辅助工具
│   ├── services/
│   │   ├── ** 服务实现 **
│   └── helpers/
│       └── ** 辅助工具 **
├── interface/               # 🎮 控制器（MCP工具注册）
│   └── controllers/
│       ├── base/
│       │   └── BaseToolsController.ts
│       ├── ** 控制器到接口 **
│       └── index.ts
├── shared/                  # 🔗 共享类型/参数
│   └── parameters/
│       └── ** 接口参数 **
└── main.ts                  # 🚀 应用程序入口点

🚀 快速开始

git clone https://github.com/alexandresanlim/mcp-server-ddd-template.git
cd mcp-server-ddd-template
npm install
npm run build

🎯 使用方法

构建后，可以直接运行服务器：

node build/main.js

或者，如果已注册为二进制文件（例如，mcp-server-ddd-template）：

npm link
mcp-server-ddd-template

服务器将在标准输出（stdio）上启动，并等待MCP请求。

🛠️ 示例中的可用工具

• 💰 get-recommended-fees： 从Mempool.space获取推荐的比特币交易费用
• 🔗 ping： 简单的健康检查端点

🔗 集成示例

要在客户端（如Claude客户端）中使用此MCP服务器作为工具提供者，您可以引用本地构建路径或使用发布的npm包。

📂 使用本地构建路径

"btc-server": {
    "command": "node",
    "args": [
        "{your project path}/mcp-server-ddd-template/build/main.js"
    ]
}

🛠️ 开发

构建命令

# 为Unix/Linux/macOS构建
npm run build

# 为Windows构建
npm run build:windows

# 运行服务器
npm run server

依赖项

• @modelcontextprotocol/sdk： MCP协议实现
• zod： 运行时类型验证
• typescript： 类型安全和编译

🤝 贡献

欢迎提交拉取请求！如果您发现这个模板仓库有用，请随意打开问题或提出改进建议。

⭐ 如果您觉得这个仓库有用，请给它点赞！