Model Context Protocol (MCP) Tutorial

Model Context Protocol (MCP) Tutorial

模型上下文协议 (MCP) 服务器的综合指南,包括安装以及与 Cursor 和 Smithery 的使用。

rams1987

开发者工具
访问服务器

README

模型上下文协议 (MCP) 教程

什么是 MCP?

模型上下文协议 (MCP) 是一种标准化协议,它能够实现开发环境(如 Cursor)和 AI 模型之间的无缝通信。它提供了一种结构化的方式来共享上下文,并将 AI 功能集成到各种工具和平台中。

快速入门指南

前提条件

  • Cursor IDE
  • Node.js 和 npm
  • Git

使用 Smithery 设置 MCP

  1. 安装 Smithery
npm install -g @cursor-ai/smithery
  1. 创建并初始化 MCP 服务器
mkdir my-mcp-server
cd my-mcp-server
smithery init
  1. 配置服务器 编辑 smithery.config.js
module.exports = {
  name: "my-mcp-server",
  version: "1.0.0",
  tools: [
    // 您的工具配置
  ]
};
  1. 启动服务器
smithery start

连接到 Cursor

  1. 打开 Cursor IDE
  2. 访问设置
  3. 找到 "MCP 服务器" 部分
  4. 添加新服务器:
    • 名称:您的服务器名称
    • URL:http://localhost:3000
    • 添加任何所需的身份验证

故障排除

常见问题

  1. 红色服务器状态

    • 验证服务器是否正在运行
    • 检查 URL 和端口
    • 验证身份验证
  2. 没有可用工具

    • 检查工具配置
    • 重启 MCP 服务器
    • 更新 Cursor
  3. 连接问题

    • 检查网络连接
    • 验证防火墙设置
    • 确认端口可用性

资源

贡献

欢迎贡献!请随意:

  • 报告问题
  • 提交 pull requests
  • 分享您的经验

许可证

MIT 许可证


上次更新:2024 年 4 月

推荐服务器

Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。

官方
精选
本地
TypeScript
MCP Package Docs Server

MCP Package Docs Server

促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档,通过多语言支持和性能优化来增强软件开发。

精选
本地
TypeScript
Claude Code MCP

Claude Code MCP

一个实现了 Claude Code 作为模型上下文协议(Model Context Protocol, MCP)服务器的方案,它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力(代码生成、编辑、审查和文件操作)。

精选
本地
JavaScript
@kazuph/mcp-taskmanager

@kazuph/mcp-taskmanager

用于任务管理的模型上下文协议服务器。它允许 Claude Desktop(或任何 MCP 客户端)在基于队列的系统中管理和执行任务。

精选
本地
JavaScript
mermaid-mcp-server

mermaid-mcp-server

一个模型上下文协议 (MCP) 服务器,用于将 Mermaid 图表转换为 PNG 图像。

精选
JavaScript
Jira-Context-MCP

Jira-Context-MCP

MCP 服务器向 AI 编码助手(如 Cursor)提供 Jira 工单信息。

精选
TypeScript
Linear MCP Server

Linear MCP Server

一个模型上下文协议(Model Context Protocol)服务器,它与 Linear 的问题跟踪系统集成,允许大型语言模型(LLM)通过自然语言交互来创建、更新、搜索和评论 Linear 问题。

精选
JavaScript
Sequential Thinking MCP Server

Sequential Thinking MCP Server

这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决,支持修订,并通过完整的 MCP 集成来实现多条解决方案路径。

精选
Python
Curri MCP Server

Curri MCP Server

通过管理文本笔记、提供笔记创建工具以及使用结构化提示生成摘要,从而实现与 Curri API 的交互。

官方
本地
JavaScript