Simple MCP Server
示例,用极简代码,演示如何构建MCP Server。
guog
README
Simple MCP Server
这是一个示例项目,用极简方式演示如何构建MCP Server。
- 天气查询:使用高德开放平台提供的天气查询API实现MCP Server,可获取实况和未来天气.
- 钉钉群消息:使用钉钉群机器人,发送消息到钉钉群。
效果演示
如上图:
- 用户问"西安今天用穿棉袄吗"
- AI自动判断是否要调用天气MCP Server
- AI按照MCP Server的参数要求,将
西安
的经纬度信息提供给MCP Server - MCP Server内部调用了高德提供的天气查询API,并将结果返回给AI
- AI将天气结果进行汇总整理,输出给用户
与钉钉群消息结合效果如下图:
环境准备
MCP Server 构建和执行
- Node.js 22+: 基础环境;
- Pnpm: 开发和构建。
MCP Client和大模型
支持MCP协议的任何AI对话客户端程序都可以,如:Cline、Continue、Claude Desktop等, 本例使用Cherry Studio。
Cherry Studio是一个AI对话客户端,其支持很多个大模型提供商,如:硅基流动、阿里云百炼、OpenAI等几十个国内外提供商,各提供商分别提供很多大模型服务,各个大模型的能力也有差异,有免费和收费的,也有不同作用和能力的。 当然,Cherry Studio也支持本地运行的大模型,如:Ollama、LLM Studio等。
本文使用硅基流动提供的Qwen2.5-7B-Instruct
模型,请先注册硅基流动账户,申请API密钥,并在Cherry Studio中配置API密钥。
注意:请选择带有Function Call
功能的大模型(Cherry Studio中带🔧符合的大模型),如:Qwen2.5-7B-Instruct
。
高德开放平台API密钥
从高德开放平台申请Web API密钥(key)。
钉钉群API密钥
注意: 钉钉的本例中采用安全设置/自定义关键字
方式,关键字为天气
,如下图所示:
构建
- Clone本项目代码到本地,如
/Users/yourname/simple-mcp-server/
目录; - 打开命令行工具;
- 跳转到此路径
cd /Users/yourname/simple-mcp-server/
; - 安装依赖
pnpm i
; - 构建
pnpm build
.
构建完成后,在项目路径下会产生build/index.js
文件。
构建的执行文件完整路径为:/Users/yourname/simple-mcp-server/build/index.js
.
安装使用
在 Cherry Studio中打开设置/MCP服务器
,添加MCP服务器,如下图:
- 名称: 随意写
- 类型:STDIO
- 命令:node
- 参数:刚才构建的执行文件路径,即
/Users/yourname/simple-mcp-server/build/index.js
- 环境变量:
GAODE_API_KEY
:高德开放平台申请的Web API 32位密钥GAODE_API_KEY=your_api_key
DINGTALK_ACCESS_TOKEN
: 创建钉钉群机器人的Webhook 地址后面的64位密钥DINGTALK_ACCESS_TOKEN=your_access_token
使用
在Cherry Studio中新建对话,对话框下方开启MCP服务器和刚才安装的MCP Server。
注意:当选择了带有Function Call
功能的大模型时,下方才有MCP相关选项。
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
MCP Package Docs Server
Facilitates LLMs to efficiently access and fetch structured documentation for packages in Go, Python, and NPM, enhancing software development with multi-language support and performance optimization.
Claude Code MCP
An implementation of Claude Code as a Model Context Protocol server that enables using Claude's software engineering capabilities (code generation, editing, reviewing, and file operations) through the standardized MCP interface.
@kazuph/mcp-taskmanager
Model Context Protocol server for Task Management. This allows Claude Desktop (or any MCP client) to manage and execute tasks in a queue-based system.
Linear MCP Server
Enables interaction with Linear's API for managing issues, teams, and projects programmatically through the Model Context Protocol.
mermaid-mcp-server
A Model Context Protocol (MCP) server that converts Mermaid diagrams to PNG images.
Jira-Context-MCP
MCP server to provide Jira Tickets information to AI coding agents like Cursor

Linear MCP Server
A Model Context Protocol server that integrates with Linear's issue tracking system, allowing LLMs to create, update, search, and comment on Linear issues through natural language interactions.

Sequential Thinking MCP Server
This server facilitates structured problem-solving by breaking down complex issues into sequential steps, supporting revisions, and enabling multiple solution paths through full MCP integration.