MCP-Server 项目文档

What is MCP-Server?

MCP-Server 是一个基于 Model Context Protocol (MCP) 的服务端和客户端实现，允许大语言模型（LLM）通过结构化协议调用外部工具完成复杂任务。它包含两部分：MCP 服务端负责注册和执行工具，以及 TypeScript 实现的客户端负责协调模型调用与工具调用。

How to use MCP-Server?

首先启动服务端 node dist/src/index.js，然后启动客户端并指定服务端脚本路径 node dist/mcp-client-typescript/src/index.js /path/to/server/script.js。也可通过 Web API 发送 POST 请求到 http://localhost:3000/sse，在请求体中传入 query 字段。

Key features of MCP-Server

• 支持天气预报和 GitHub 用户信息查询工具
• 通过标准输入输出（stdio）与服务端通信
• 集成 Deepseek 大语言模型（通过 OpenAI 兼容 API）
• 提供命令行交互界面和 Express Web API
• 支持流式输出和白盒过程可视化

Use cases of MCP-Server

• 让 LLM 实时获取天气数据并回答相关问题
• 让 LLM 查询 GitHub 用户信息并整合回答
• 作为学习 MCP 协议和工具调用架构的参考示例
• 在 Web 应用中通过 HTTP 接口调用增强 LLM 能力

FAQ from MCP-Server

需要哪些环境变量？

需要在 .env 文件中设置 LLM_API_KEY（Deepseek API 密钥）和 GAODE_KEY（高德地图 API 密钥，用于天气查询）。

客户端默认使用哪个大语言模型？

客户端默认使用 Deepseek，通过 OpenAI 兼容 API 进行通信。

服务端和客户端如何通信？

服务端和客户端通过标准输入输出（stdio）进行通信，使用 Model Context Protocol 协议。

如何查看白盒过程可视化？

客户端实现了白盒过程展示，用户可以看到意图识别、工具选择、工具调用参数与结果以及最终答案生成过程。