Cipta Pelayan MCP untuk Kod Claude — panduan praktikal dan terkini

CometAPI
AnnaNov 22, 2025
Cipta Pelayan MCP untuk Kod Claude — panduan praktikal dan terkini

Protokol Konteks Model (MCP) ialah piawaian terbuka yang membenarkan model seperti Anthropic Claude dan alat pembangun seperti Kod Claude panggil alat luaran, sumber data dan gesaan dengan cara yang selamat dan standard.

Panduan ini akan membimbing anda membina pelayan MCP anda sendiri dari awal, membolehkan Kod Claude mengakses ciri tersuai dan dengan itu meluaskan fungsinya jauh melebihi ciri terbina dalamnya.

Apakah itu Model Context Protocol (MCP)?

MCP (Model Context Protocol) ialah sebuah spesifikasi terbuka direka untuk menyeragamkan cara klien model bahasa (seperti Claude, Claude Code atau bahagian hadapan LLM lain) menyambung ke pelayan alat dan sumber data. Fikirkan MCP sebagai "port USB-C untuk LLM": ia mentakrifkan skema pengangkutan/JSON-RPC dan cara biasa untuk pelayan menerbitkan tiga jenis keupayaan:

  • Sumber — data seperti fail atau dokumen yang boleh dibaca oleh pelanggan (cth, baris pangkalan data, fail teks, muatan JSON).
  • Alatan — fungsi boleh panggil yang model boleh meminta hos untuk melaksanakan (dengan kelulusan pengguna).
  • Prompts — templat gesaan boleh diguna semula atau aliran kerja yang model/klien boleh gunakan.

MCP menyokong berbilang pengangkutan (stdio, HTTP, SSE) dan menyediakan skema, SDK dan pelayan contoh supaya anda tidak perlu mencipta sendiri format wayar. Protokol ini dikekalkan secara terbuka (spesifikasi + SDK) dan mempunyai tutorial serta galeri contoh pelayan untuk mempercepatkan penggunaan.

Bagaimanakah MCP diarkitek?

Seni bina MCP sengaja ringkas dan modular: bahagian teras ialah MCP pelayan, MCP pelanggan, dan Pengangkutan yang membawa mesej berbingkai JSON-RPC di antara mereka. Di bawah ialah komponen utama yang anda akan berinteraksi semasa membina pelayan untuk Kod Claude (atau klien MCP lain).

Pelayan, klien dan protokol

  • pelayan MCP - Perkhidmatan yang menerbitkan alat, sumber dan gesaan. Alat boleh melakukan kesan sampingan atau mengambil data; kandungan baca sahaja permukaan sumber; gesaan ialah templat gesaan boleh guna semula yang pelanggan boleh minta model untuk dijadikan sampel.
  • Pelanggan MCP (hos) — Biasanya sebahagian daripada hos LLM (cth, Claude Code, VS Code plugin, klien penyemak imbas). Ia menemui pelayan yang tersedia, membentangkan penerangan alat kepada model dan mengarahkan panggilan yang dimulakan model ke pelayan.
  • Protokol — Mesej dikodkan sebagai JSON-RPC; spesifikasi mentakrifkan peristiwa kitaran hayat, penemuan alat, permohonan, penyiapan/pensampelan dan cara hasil berstruktur diangkut kembali kepada klien dan model.

Corak komunikasi (apa yang berlaku apabila alat digunakan)

  1. Pelanggan menghantar mesej pengguna kepada model.
  2. Model menganalisis konteks dan memutuskan untuk memanggil alat yang didedahkan oleh MCP (atau berbilang alatan).
  3. Pelanggan memajukan panggilan alat ke pelayan MCP melalui pengangkutan yang dipilih.
  4. Pelayan melaksanakan alat dan mengembalikan hasil.
  5. Model menerima output alat dan menyusun jawapan akhir kepada pengguna.

Primitif pelaksanaan

  • JSON-RPC mesej mengikut skema MCP.
  • Definisi alat diterbitkan dalam respons penemuan pelayan supaya pelanggan boleh membentangkannya dalam UI.
  • Sumber dirujuk oleh @source:path sintaks oleh pelanggan (cth, @postgres:...), membenarkan model merujuk kepada kandungan luaran tanpa memasukkan data yang besar ke dalam gesaan.

Mengapa menyepadukan Kod Claude dengan pelayan MCP?

Kod Claude ialah tawaran Anthropic yang tertumpu pada aliran kerja tertumpu kod dan pembangun (penyepaduan editor/IDE, pemahaman kod, dsb.). Mendedahkan alatan dalaman anda (carian sumber, pelari CI, sistem tiket, pendaftaran peribadi) melalui pelayan MCP membolehkan Kod Claude memanggilnya sebagai alatan kelas pertama perbualan pengekodan dalam dan aliran ejen.

Mengintegrasikan Kod Claude dengan pelayan MCP membuka kunci keupayaan praktikal, berkaitan pengeluaran untuk ejen pengekodan:

1. Biarkan model bertindak pada sistem sebenar

Claude Code boleh meminta pelayan MCP untuk menanyakan penjejak isu, menjalankan pertanyaan pangkalan data, membaca dokumen besar atau menghasilkan PR GitHub — membolehkan automasi hujung ke hujung dari dalam sesi pengekodan. Ini disokong secara jelas oleh dokumen Kod Claude (contoh: menanyakan Postgres, Sentry atau membuat PR).

2. Muatkan data besar dan logik khusus

Daripada membenamkan setiap sumber data ke dalam gesaan (yang menggunakan token), anda menerbitkan data dan alatan melalui MCP. Model memanggil alat itu, mendapat respons berstruktur dan memberi alasan dengannya — ini mengurangkan penggunaan token dan membolehkan pelayan mengendalikan kerja berat (pertanyaan DB, bacaan fail panjang, pengesahan).

3. Keselamatan dan tadbir urus

MCP memusatkan kawalan akses dan pengauditan pada lapisan pelayan, membenarkan organisasi menyenarai putih pelayan yang diluluskan, mengawal alat yang tersedia dan mengehadkan output. Kod Claude juga menyokong konfigurasi MCP perusahaan dan persetujuan setiap skop.

4. Kebolehgunaan semula dan ekosistem

Pelayan MCP boleh diguna semula merentas pelanggan dan pasukan. Bina sekali dan ramai pelanggan Claude/LLM boleh menggunakan perkhidmatan yang sama (atau swap pelaksanaan).

Apa yang anda perlukan sebelum anda mula?

Keperluan minimum

  • Mesin pembangunan dengan Python 3.10+ (kami akan menggunakan Python dalam contoh). Sebagai alternatif Node / bahasa lain disokong oleh SDK MCP.
  • uv (alat Astral) atau pelari yang setara untuk menjalankan pelayan stdio MCP (tutorial MCP menggunakan uv). Langkah-langkah pemasangan ditunjukkan di bawah.
  • Claude Code dipasang atau akses kepada klien Claude (desktop atau CLI) untuk mendaftar dan menguji pelayan anda; atau mana-mana pelanggan berkemampuan MCP. Claude Code menyokong HTTP, SSE dan pelayan stdio tempatan.
  • Nota keselamatan: Hanya tambahkan pelayan MCP yang dipercayai pada Kod Claude dalam tetapan pasukan atau perusahaan — MCP memberikan pelayan akses kepada data sensitif dan risiko suntikan segera wujud jika pelayan mengembalikan kandungan berniat jahat.

Cara memasang dan mengesahkan CLI Kod Claude

Ini adalah Panduan Pemasangan dan Penggunaan Kod Claude.

1) Ringkasan pantas — kaedah pemasangan yang disyorkan

Menggunakan pemasang asli (disyorkan) atau Homebrew pada macOS/Linux. NPM tersedia jika anda memerlukan pemasangan berasaskan Node. Windows mendapat pemasang PowerShell / CMD. Sumber: dokumen Kod Claude rasmi & GitHub.

2) Prasyarat

  • macOS 10.15+, Ubuntu 20.04+/Debian 10+ atau Windows 10+ (WSL disyorkan pada Windows).
  • Node.js 18+ hanya diperlukan untuk kaedah pemasangan NPM.

3) Arahan pemasangan (pilih satu)

Asli (disyorkan — tiada pergantungan Nod)，macOS / Linux / WSL:

curl -fsSL https://claude.ai/install.sh | bash
# optional: install latest explicitly

curl -fsSL https://claude.ai/install.sh | bash -s latest
# or install a specific version

curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex
# or for latest: & (::Create((irm https://claude.ai/install.ps1))) latest

(Ini ialah skrip pemasang asli rasmi).

NPM (jika anda mahukan pemasangan global berasaskan Node):

# requires Node.js 18+

npm install -g @anthropic-ai/claude-code

Jangan penggunaan sudo npm install -g — memberi amaran terhadap pemasangan global sudo (isu kebenaran/keselamatan). Jika anda menekan ralat kebenaran, gunakan nvm atau betulkan awalan global npm anda daripada menggunakan sudo.

4) Sahkan binari telah dipasang (semakan asas)

Jalankan ini secara tempatan sejurus selepas pemasangan:

# is the command on PATH?

which claude

# version (or -v)

claude --version
# or

claude -v

# help (sanity check)

claude --help

Dijangkakan: which menunjukkan laluan (cth /usr/local/bin/claude or ~/.nvm/.../bin/claude) dan claude --version mencetak rentetan seperti semver. Dokumen dan README menunjukkan kedua-duanya claude sebagai titik masuk CLI utama.

5) Sahkan kesihatan pemasangan dan konfigurasi (semakan yang disyorkan)

a) claude doctor，Larikan:

claude doctor

Diagnostik terbina dalam ini menyemak jenis pemasangan anda, masalah biasa (seperti isu kebenaran npm), kebergantungan seperti ripgrep, dan mencadangkan pembetulan. Dokumen secara eksplisit mengesyorkan berjalan claude doctor selepas dipasang.

b) Jalankan ujian asap (tidak interaktif)

Daripada direktori projek anda:

cd /path/to/your/project
claude -p "Explain this project in 3 sentences"

Ini menggunakan cetak mod (-p) untuk menghantar satu gesaan kemudian keluar; bagus untuk CI atau semakan fungsi pantas.

c) Pengesahan pengesahan (pastikan CLI boleh mencapai Anthropic)

Kod Claude menyokong beberapa aliran pengesahan (OAuth Konsol, kunci API, penyepaduan penyedia). Pemeriksaan biasa:

  1. Jika menggunakan kunci API (CI / tanpa kepala / local env var):
export ANTHROPIC_API_KEY="sk-..."
# then

claude auth status
claude auth whoami    # or `claude auth whoami` / `claude whoami` depending on version

Anda boleh menggunakan CometAPIKunci API untuk menggunakan Kod Claude, Menggunakan API Claude melalui CometAPI akan memberi anda diskaun sebanyak 20%.

  1. Jika anda menggunakan OAuth melalui konsol - lari:
claude auth status
claude auth whoami

Anda seharusnya melihat maklumat akaun/pelan atau pengesahan bahawa anda telah disahkan.

Penyediaan persekitaran langkah demi langkah

Di bawah ialah langkah konkrit untuk menyediakan dua tindanan pembangun biasa (TypeScript dan Python), diikuti dengan semakan pantas untuk memastikan semuanya berfungsi.

H3 — A. Persediaan TypeScript / Nod (laluan terpantas)

  1. Buat projek dan pasang SDK:
mkdir mcp-demo && cd mcp-demo
npm init -y
npm install @modelcontextprotocol/sdk express zod
npm install --save-dev typescript tsx @types/node @types/express
  1. Buat server.ts. (Kami menyediakan contoh penuh dalam bahagian “Cara Membina Pantas…”.)
  2. Jalankan:
npx -y tsx server.ts
  1. Uji secara tempatan dengan Pemeriksa MCP atau tambahkan pada Kod Claude:
npx @modelcontextprotocol/inspector
# or (for Claude Code)

claude mcp add --transport http my-server http://localhost:3000/mcp

(Arahan Inspektor dan Claude membolehkan anda mengesahkan penemuan dan menggunakan alatan.)

Bagaimana untuk membina pelayan MCP untuk Kod Claude dengan cepat?

senarai semak cepat

1.Mulakan pelayan anda (Streamable HTTP disyorkan): node server.ts or uvicorn server:app.

  1. Daripada mesin dev anda, sama ada:
  • Penggunaan Pemeriksa MCP untuk mengesahkan (npx @modelcontextprotocol/inspector) dan mengesahkan tools/list and resources/list; Atau
  • Tambahkan pelayan ke Kod Claude: claude mcp add --transport http <name> http://<host>:<port>/mcp (atau ikut aliran UI web jika pelanggan anda menyokong MCP jauh).

Jika anda bercadang untuk menggunakan penyambung API Mesej Anthropic untuk MCP jauh (tiada klien berasingan), baca dokumen Claude — pengepala beta mungkin diperlukan (semak dokumen untuk pengepala yang tepat dan status sokongan semasa).

Di bawah ialah dua contoh pelayan yang lengkap tetapi padat yang anda boleh salin, jalankan dan sambungkan kepada Kod Claude (atau Pemeriksa MCP). Contoh TypeScript menggunakan Express + TypeScript SDK; contoh Python menunjukkan pemasangan FastAPI.

Nota: kod di bawah mengikut contoh SDK awam dan sengaja minimum untuk kejelasan. Untuk pengeluaran, tambahkan pengesahan, pengelogan, pengehadan kadar dan pengesahan input melebihi lalai SDK.

Contoh 1: TypeScript + Express (Streamable HTTP)

Buat server.ts (lengkap):

// server.ts
import express from "express";
import * as z from "zod/v4";
import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";

const server = new McpServer({ name: "claude-code-demo", version: "0.1.0" });

// Register a simple tool: add two numbers
server.registerTool(
  "add",
  {
    title: "Add",
    description: "Add two numbers a and b",
    inputSchema: { a: z.number(), b: z.number() },
    outputSchema: { result: z.number() }
  },
  async ({ a, b }) => {
    const output = { result: a + b };
    return {
      content: ,
      structuredContent: output
    };
  }
);

// Register a resource: greet user (dynamic)
server.registerResource(
  "greeting",
  new ResourceTemplate("greeting://{name}", { list: undefined }),
  { title: "Greeting", description: "Return a greeting for the name" },
  async (uri, params) => {
    return {
      contents: 
    };
  }
);

// Express + Streamable HTTP transport
const app = express();
app.use(express.json());

app.post("/mcp", async (req, res) => {
  const transport = new StreamableHTTPServerTransport({ enableJsonResponse: true });
  // Close transport when connection closes
  res.on("close", () => transport.close());
  await server.connect(transport);
  await transport.handleRequest(req, res, req.body);
});

const port = parseInt(process.env.PORT || "3000", 10);
app.listen(port, () => console.log(`MCP server listening: http://localhost:${port}/mcp`));

Jalankan:

npm install
npx -y tsx server.ts

Kemudian sambungkan dalam Kod Claude (contoh):

# Add the remote server to your Claude Code MCP list (local dev)

claude mcp add --transport http my-demo http://localhost:3000/mcp

Contoh ini diadaptasi daripada Permulaan Pantas SDK TypeScript rasmi dan menunjukkan cara mendaftar alatan dan sumber, kemudian mendedahkannya melalui HTTP Boleh Strim.

Contoh 2: Python + FastAPI (FastMCP + HTTP Boleh Stream)

Buat server.py (lengkap):

# server.py

from fastapi import FastAPI
from mcp.server.fastmcp import FastMCP

app = FastAPI()
mcp = FastMCP("claude-python-demo", stateless_http=True)

# tool: simple sum

@mcp.tool()
def add(a: int, b: int) -> dict:
    """Add two integers"""
    return {"result": a + b}

# resource: simple greeting resource template

@mcp.resource("greeting://{name}")
def greeting(name: str):
    return {"contents": }

# mount the streamable-http MCP endpoint (FastMCP exposes an ASGI app)

app.mount("/mcp", mcp.streamable_http_app())

# optional endpoint to demonstrate other API routes

@app.get("/")
async def root():
    return {"status": "OK"}

Jalankan:

uvicorn server:app --reload --port 8000

Berhubung dengan Inspektor:

npx @modelcontextprotocol/inspector
# In Inspector select Streamable HTTP and enter http://localhost:8000/mcp

Contoh Python SDK dan utiliti FastMCP menjadikannya mudah untuk mendaftar @mcp.tool() and @mcp.resource() fungsi berhias yang boleh ditemui dan dipanggil oleh LLM.

Bagaimanakah Claude Code sebenarnya memanggil alatan anda?

Apabila LLM memutuskan untuk menggunakan alat, klien menghantar seruan JSON-RPC ke pelayan MCP. Pelayan melaksanakan alat yang diminta (contohnya, pertanyaan DB, menjalankan ujian atau memanggil API luaran) dan mengembalikan kandungan berstruktur and kandungan yang boleh dipersembahkan. Pelanggan (Kod Claude) kemudiannya boleh memasukkan output berstruktur dalam konteks model supaya model boleh meneruskan penaakulan dengan data yang boleh dipercayai itu — bukan hanya output teks pelayan. SDK TypeScript menyokong pendaftaran inputSchema and outputSchema (zod) jadi hujah dan output disahkan dan ditaip mesin.

Apakah alat ujian dan penyahpepijatan yang patut anda gunakan?

Pemeriksa MCP

. Pemeriksa MCP ialah alat pembangun visual rasmi untuk menguji pelayan MCP. Ia membolehkan anda menyambung ke pelayan (stdio, SSE, atau boleh strim-HTTP), senarai alat, memanggilnya secara manual dan memeriksa kitaran hayat mesej JSON-RPC — tidak ternilai semasa pembangunan. Mulakannya melalui npx @modelcontextprotocol/inspector.

Ujian tempatan lwn Jauh

  • Setempat (stdio) — kitaran lelaran pantas untuk apl desktop dan penyahpepijatan luar talian.
  • HTTP boleh strim — uji dengan Inspektor atau sambungkan kepada Claude Code menggunakan claude mcp add CLI atau penyambung MCP dalam Messages API untuk ujian jauh. Pastikan anda membekalkan sebarang pengepala auth yang diperlukan untuk pelayan anda.

Kesimpulan

MCP ialah jambatan praktikal antara LLM moden dan sistem yang benar-benar memegang data dan melakukan tindakan. Untuk aliran kerja kod, menyepadukan Kod Claude dengan pelayan MCP memberikan model berstruktur, akses boleh diaudit kepada repositori, CI, penjejak isu dan alatan tersuai—menghasilkan automasi yang lebih tepat dan kesan sampingan yang lebih selamat. Dengan SDK rasmi dalam TypeScript dan Python, HTTP Boleh Stream untuk pengehosan jauh dan alatan seperti MCP Inspector, anda boleh membina pelayan minimum dalam beberapa minit dan beralih ke arah penggunaan pengeluaran.

Pembangun boleh mengakses API Claude Sonnet 4.5 and Claude Opus 4.1 API dan lain-lain melalui CometAPI, versi model terkini sentiasa dikemas kini dengan laman web rasmi. Untuk memulakan, terokai keupayaan model dalam Taman Permainan dan berunding dengan Panduan API untuk arahan terperinci. Sebelum mengakses, sila pastikan anda telah log masuk ke CometAPI dan memperoleh kunci API. CometAPI menawarkan harga yang jauh lebih rendah daripada harga rasmi untuk membantu anda menyepadukan.

Bersedia untuk Pergi?→ Daftar untuk CometAPI hari ini !

Jika anda ingin mengetahui lebih banyak petua, panduan dan berita tentang AI, ikuti kami VK, X and Perpecahan!

Baca Lagi

500+ Model dalam Satu API

Sehingga 20% Diskaun