极客前沿

AI 入门:装好 MCP 环境,第一次跑通代码

2026-05-11 01:33
DEV Machine Learning
查看原文

从零开始安装 MCP SDK,配置开发环境,运行第一个工具调用示例,体验 AI 编程的简化流程。

准备环境:装好 Node.js 和编辑器

在开始之前,你需要 Node.js(一个让 JavaScript 在电脑上运行的环境,类似手机需要系统才能装 App)和一个 代码编辑器(用来写代码的软件,推荐 VS Code)。

Tutorial Image
  • 下载 Node.js:访问 nodejs.org,点击左侧 LTS 版本(稳定版),安装时一路点“下一步”。
  • 检查是否成功:打开终端(Mac 的“终端”或 Windows 的“命令提示符”),输入 node -v,如果显示版本号(如 v20.11.0)就对了。
  • 安装 VS Code:从 code.visualstudio.com 下载,安装后打开。

安装 MCP SDK:一行命令搞定

MCP(Model Context Protocol)是一种让 AI 程序能调用工具(比如读取文件、发送请求)的协议。它的 SDK(软件开发工具包)就是帮你快速用上这个协议的工具包。

Tutorial Image
  1. 在终端里新建一个文件夹:mkdir my-mcp-project 然后 cd my-mcp-project
  2. 初始化项目:npm init -y(这会在文件夹里生成一个 package.json 文件)。
  3. 安装 MCP SDK:npm install @anthropic-ai/sdk(注意:这是示例,实际请根据官方最新文档替换包名)。
  4. 等待安装完成,终端出现“added 1 package”就成功了。
  5. 写第一个脚本:让 AI 调用工具

    现在写一个简单的 JavaScript 文件,让 AI 通过 MCP 执行一个任务——比如搜索并返回结果。

    Tutorial Image
    1. my-mcp-project 文件夹里新建一个文件,叫 index.js
    2. 复制以下代码(这是简化版,重点看结构):
      const { Anthropic } = require('@anthropic-ai/sdk');
      const client = new Anthropic({ apiKey: 'your-api-key' });
      
      async function main() {
        const response = await client.messages.create({
          model: 'claude-3-5-sonnet-20241022',
          max_tokens: 1024,
          messages: [{ role: 'user', content: '搜索 AI 入门教程' }],
        });
        console.log(response.content);
      }
      main();
    3. your-api-key 替换成你的 API 密钥(去 Anthropic 官网注册获取)。
    4. 在终端运行:node index.js
    5. 如果看到一段 JSON 格式的回复,就说明跑通了!

    常见坑:忘记替换 API 密钥会报错;如果提示“找不到模块”,先检查是否在项目文件夹里运行。

    下一步:理解“代码模式”

    传统做法是把所有工具描述塞给 AI,导致消耗大量 token(可以理解为“对话次数”)。而 Code Mode 让 AI 自己写代码去调用工具,只加载需要的部分——就像你只打开需要的 App,而不是一次性打开所有 App。你可以尝试修改代码,让 AI 调用更多自定义工具,比如读取文件或发送邮件。

内容来源

DEV Machine Learning

发布时间

2026-05-11 01:33

返回 AI技术