Skip to main content
Glama

Custom Context MCP Server

by jiliangmason
MIT License

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调试

  1. 启动服务器
    pnpm run dev
  2. 访问mcp-inspector
    • 服务器启动后会自动打开mcp-inspector界面
    • 或者手动访问:http://localhost:6274
  3. 测试工具
    • 在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格式,基于原始模板结构。

开发指南

添加新工具

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

调试技巧

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

常见问题

端口被占用
# 检查端口占用 lsof -i :3005 lsof -i :6274
构建错误
# 清理并重新构建 rm -rf build/ pnpm run build
依赖问题
# 重新安装依赖 pnpm install

技术栈

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

许可证

ISC

-
security - not tested
A
license - permissive license
-
quality - not tested

A FastMCP-based server that supports SSE real-time event streaming and tool calling, with features for text-to-JSON conversion and grouping text by JSON templates.

  1. 功能特性
    1. 快速开始
      1. 安装依赖
      2. 开发模式
      3. 生产模式
    2. 调试指南
      1. 使用mcp-inspector调试
      2. 服务器端点
      3. 测试工具
    3. 项目结构
      1. 工具功能
        1. 1. group-text-by-json
        2. 2. text-to-json
      2. 开发指南
        1. 添加新工具
        2. 调试技巧
        3. 常见问题
      3. 技术栈
        1. 许可证

          Related MCP Servers

          • -
            security
            A
            license
            -
            quality
            A server that provides MySQL database operations through SSE (Server-Sent Events) based on the MCP (Model-Controller-Provider) framework, enabling real-time data transmission from MySQL databases.
            Last updated -
            67
            Python
            MIT License
            • Linux
            • Apple
          • A
            security
            F
            license
            A
            quality
            An implementation of the Model Context Protocol (MCP) server using Server-Sent Events (SSE) for real-time communication, providing tools for calculations and dynamic resource templates.
            Last updated -
            1
            JavaScript
          • -
            security
            F
            license
            -
            quality
            A server for Model Context Protocol (MCP) that uses Server-Sent Events (SSE) for streaming communication, enabling tools like the HackerNews API to be accessed through a secure HTTP+SSE transport.
            Last updated -
            23
            TypeScript
          • -
            security
            F
            license
            -
            quality
            A FastAPI server that implements the Model Context Protocol (MCP) using Server-Sent Events (SSE) transport to provide random cat facts on demand or as a continuous stream.
            Last updated -
            Python
            • Linux
            • Apple

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/jiliangmason/custom-mcp-server'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server