custom-mcp-server by jiliangmason - MCP Server

Custom Context MCP Server

基于FastMCP框架的MCP服务器，支持SSE实时事件流和工具调用。

功能特性

✅ 基于FastMCP框架
✅ SSE实时事件流
✅ HTTP健康检查端点
✅ 支持mcp-inspector调试
✅ TypeScript类型安全
✅ 热重载开发模式

快速开始

安装依赖

pnpm install

开发模式

# 启动开发服务器（包含mcp-inspector）
pnpm run dev

# 或者启动监听模式
pnpm run dev:watch

生产模式

# 构建项目
pnpm run build

# 启动服务器
pnpm start

调试指南

使用mcp-inspector调试

启动服务器：
```
pnpm run dev
```
访问mcp-inspector：
- 服务器启动后会自动打开mcp-inspector界面
- 或者手动访问：http://localhost:6274
测试工具：
- 在mcp-inspector中选择工具
- 输入参数并执行
- 查看实时结果

服务器端点

SSE端点: http://localhost:3005/sse
健康检查: http://localhost:3005/health
mcp-inspector: http://localhost:6274

测试工具

group-text-by-json

{
  "template": "{\"name\": \"string\", \"age\": \"number\", \"city\": \"string\"}"
}

text-to-json

{
  "template": "{\"name\": \"string\", \"age\": \"number\", \"city\": \"string\"}",
  "text": "name: John Doe\nage: 25\ncity: Beijing"
}

项目结构

src/
├── common/
│   ├── constants.ts    # 常量定义
│   ├── tools.ts        # 工具实现
│   ├── types.ts        # 类型定义
│   └── utils.ts        # 工具函数
└── index.ts           # 主入口文件

工具功能

1. group-text-by-json

根据JSON模板生成文本分组提示词，帮助AI将文本按模板结构分组。

2. text-to-json

将分组文本转换为JSON格式，基于原始模板结构。

开发指南

添加新工具

在 src/common/types.ts 中定义工具schema
在 src/common/tools.ts 中实现工具逻辑
在 src/common/constants.ts 中添加工具名称
在 src/index.ts 中注册工具

调试技巧

查看日志: 服务器会输出详细的日志信息
SSE连接: 可以通过浏览器访问SSE端点查看实时事件
健康检查: 访问健康检查端点确认服务器状态
热重载: 开发模式下支持代码热重载

常见问题

端口被占用

# 检查端口占用
lsof -i :3005
lsof -i :6274

构建错误

# 清理并重新构建
rm -rf build/
pnpm run build

依赖问题

# 重新安装依赖
pnpm install

技术栈

FastMCP: MCP协议实现框架
Express: HTTP服务器和中间件
TypeScript: 类型安全
SSE: 服务器发送事件
Zod: 数据验证

许可证

ISC