JinDaGe - mcp-local-spec MCP Details

article

README

🚀 本地 MCP 服务器的规范

本规范致力于提供一种标准方法，让用户能在本地机器上列出并配置 MCP 服务器。当下，众多工具借助 MCP 服务器来强化 LLM 功能，但却缺乏快速注册 MCP 服务器的标准方式。

🚀 快速开始

MCP 客户端可利用 LLM（如 Claude、ChatGPT）从 ~/.mcp 文件夹（Windows 上为 %USER_HOME%）下的所有可用 MCP 服务器的 Markdown 文件中提取必要信息。客户端需定期从磁盘刷新文件，以发现新的 MCP 服务器。

✨ 主要特性

为本地机器上的 MCP 服务器提供标准的列出和配置方式。
支持多种流行的 MCP 客户端，如 IntelliJ IDEA、Anthropic Claude、OpenAI ChatGPT 等。

📦 安装指南

此部分暂未涉及具体安装步骤，故跳过。

💻 使用示例

基本用法

在 ~/.mcp 文件夹（Windows 上的 %USER_HOME%）中为每个 MCP 服务器创建一个 Markdown 文件，例如：

~/.mcp/my-mcp-server-tool-id.md

在文件中创建以下文本：

---
version: 1.0.1
---

# MCP 服务器：生产环境

在这里，我描述我的MCP服务器正在做什么，以及LLM为什么会在特定请求中决定包含我的服务器。

## 基本信息
- **名称**：Production Jonnyzzz MCP Server
- **ID**：prod-mcp-01
- **版本**：3.2.1
- **URL**：https://mcp-prod.jonnyzzz.com:8443
- **API 版本**：v2

## 身份验证
- **类型**：oauth2
- **客户端 ID**：client_123
- **令牌端点**：https://auth.example.com/token

## 功能
- compute
- storage
- networking

## 地区
### us-east
- us-east-1a
- us-east-1b

### eu-west
- eu-west-1a
- eu-west-1b

## 健康检查
- **端点**：/health
- **间隔时间**：60秒

## 元数据
- **环境**：生产
- **所有者**：platform-team
- **优先级**：高

📚 详细文档

版本

当前版本为 1.0.1。

目标

该规范旨在允许在本地机器上以“标准方式”列出和配置 MCP 服务器。

已支持的工具

若您的工具支持该规范，欢迎提交 PR。

规范

在 ~/.mcp 文件夹（Windows 上的 %USER_HOME%）中为每个 MCP 服务器创建一个 Markdown 文件，向 LLM 解释 MCP 服务器详细信息，客户端需将 LLM 的解释转换为可操作的 MCP 服务器。
客户端必须定期从磁盘刷新信息以发现新 MCP 服务器。
此协议不解决任何与 MCP 服务器相关的安全问题，安全问题仍由 MCP 客户端负责。

如何使用该规范

MCP 客户端使用 LLM 从 ~/.mcp 文件夹下的所有可用 MCP 服务器的 Markdown 文件中提取必要信息。是否使用特定 LLM、请求凭证等，由 LLM 和客户端决定。客户端应定期从磁盘刷新文件。

🔧 技术细节

此部分暂未涉及具体技术细节，故跳过。

📄 许可证

此部分未提及许可证信息，故跳过。

mcp-local-spec