Model Context Protocol Servers Kco

🚀 模型上下文協議（Model Context Protocol）中文指南

模型上下文協議（Model Context Protocol，簡稱 MCP）是一套開放標準，用於連接大型語言模型（LLM）與外部工具和數據源。藉助 MCP，開發者能輕鬆將各類工具集成到 LLM 的工作流程中，使模型可訪問文件系統、數據庫、API 等多種資源。

🚀 快速開始

使用本倉庫中的 MCP 服務器

基於 TypeScript 的服務器可直接使用 npx 運行。例如，運行以下命令可啟動 Memory 服務器：

npx -y @modelcontextprotocol/server-memory

Python 基礎的服務器可通過 uvx 或 pip 運行，推薦使用 uvx 以簡化安裝和配置。例如，運行以下命令可啟動 Git 服務器：

# 使用 uvx
uvx mcp-server-git

# 使用 pip
pip install mcp-server-git
python -m mcp_server_git

請按照 這些 指引安裝 uv / uvx，以及 這些 安裝 pip。

使用 MCP 客戶端

僅運行一個服務器意義不大，通常需將服務器配置到 MCP 客戶端中使用。例如，以下是在 Claude Desktop 中配置使用上述服務器的示例：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

更多關於使用 Claude Desktop 作為 MCP 客戶端的示例配置如下：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
    },
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git", "--repository", "path/to/git/repo"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    }
  }
}

✨ 主要特性

模型上下文協議（MCP）作為連接大型語言模型與外部工具和數據源的開放標準，具有以下顯著特性：

• 開放性：作為開放標準，MCP 為開發者提供了統一的規範，促進了不同工具和數據源之間的互聯互通，推動了 AI 生態系統的開放與協作。
• 集成便捷性：開發者可以輕鬆地將各種工具集成到 LLM 的工作流程中，無需複雜的配置和開發，大大提高了開發效率。
• 資源豐富性：使得模型能夠訪問文件系統、數據庫、API 等多種資源，拓展了模型的應用場景和能力邊界。

📦 安裝指南

TypeScript 服務器

基於 TypeScript 的服務器可直接使用 npx 運行，如啟動 Memory 服務器的命令：

npx -y @modelcontextprotocol/server-memory

Python 服務器

Python 基礎的服務器可通過 uvx 或 pip 運行。

• 使用 uvx：

uvx mcp-server-git

• 使用 pip：

pip install mcp-server-git
python -m mcp_server_git

請按照 這些 指引安裝 uv / uvx，以及 這些 安裝 pip。

💻 使用示例

基礎用法

在 Claude Desktop 中配置使用 Memory 服務器的示例：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

高級用法

更多關於使用 Claude Desktop 作為 MCP 客戶端的示例配置，可集成多種服務器：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
    },
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git", "--repository", "path/to/git/repo"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    }
  }
}

📚 詳細文檔

若您有興趣創建自己的 MCP 服務器，請訪問官方文檔 modelcontextprotocol.io 查看詳細的指南、最佳實踐和技術細節。

🤝 貢獻

關於如何為本倉庫做貢獻，請參閱 CONTRIBUTING.md 文件。

🔒 安全

有關安全漏洞的報告，請參閱 SECURITY.md 文件。

📄 許可證

此項目遵循 MIT 許可證 - 請查看 LICENSE 文件以獲取詳細信息。

👥 社區

• GitHub Discussions

🛠️ 支持

如需聯繫或尋求幫助，請訪問 支持頁面 或發送郵件至 support@yourdomain.com。

感謝您對模型上下文協議的支持與貢獻！通過 MCP，我們正在構建一個更加智能和互聯的 AI 生態系統。