Skip to content

Latest commit

 

History

History
846 lines (682 loc) · 40.2 KB

File metadata and controls

846 lines (682 loc) · 40.2 KB

ชุมชนและการมีส่วนร่วม

ภาพรวม

บทเรียนนี้เน้นไปที่วิธีการมีส่วนร่วมกับชุมชน MCP การสนับสนุนระบบนิเวศของ MCP และการปฏิบัติตามแนวทางที่ดีที่สุดสำหรับการพัฒนาร่วมกัน การเข้าใจวิธีการเข้าร่วมในโครงการโอเพนซอร์สของ MCP เป็นสิ่งสำคัญสำหรับผู้ที่ต้องการมีส่วนร่วมในการกำหนดอนาคตของเทคโนโลยีนี้

วัตถุประสงค์การเรียนรู้

เมื่อจบบทเรียนนี้ คุณจะสามารถ:

  • เข้าใจโครงสร้างของชุมชนและระบบนิเวศของ MCP
  • มีส่วนร่วมอย่างมีประสิทธิภาพในฟอรัมและการสนทนาของชุมชน MCP
  • สนับสนุนโครงการโอเพนซอร์สของ MCP
  • สร้างและแบ่งปันเครื่องมือและเซิร์ฟเวอร์ MCP ที่กำหนดเอง
  • ปฏิบัติตามแนวทางที่ดีที่สุดสำหรับการพัฒนาและความร่วมมือใน MCP
  • ค้นพบทรัพยากรและกรอบงานของชุมชนสำหรับการพัฒนา MCP

ระบบนิเวศชุมชน MCP

ระบบนิเวศของ MCP ประกอบด้วยส่วนประกอบและผู้เข้าร่วมหลากหลายที่ทำงานร่วมกันเพื่อพัฒนาโปรโตคอลนี้

ส่วนประกอบหลักของชุมชน

  1. ผู้ดูแลโปรโตคอลหลัก: องค์กร Model Context Protocol GitHub อย่างเป็นทางการที่ดูแลสเปคหลักของ MCP และการใช้งานอ้างอิง
  2. นักพัฒนาเครื่องมือ: บุคคลและทีมที่สร้างเครื่องมือและเซิร์ฟเวอร์ MCP
  3. ผู้ให้บริการบูรณาการ: บริษัทที่ผสาน MCP เข้ากับผลิตภัณฑ์และบริการของตน
  4. ผู้ใช้งานปลายทาง: นักพัฒนาและองค์กรที่ใช้ MCP ในแอปพลิเคชันของตน
  5. ผู้มีส่วนร่วม: สมาชิกชุมชนที่สนับสนุนด้วยโค้ด เอกสาร หรือทรัพยากรอื่น ๆ

ทรัพยากรของชุมชน

ช่องทางอย่างเป็นทางการ

ทรัพยากรที่ขับเคลื่อนโดยชุมชน

  • MCP Clients - รายชื่อลูกค้าที่รองรับการบูรณาการ MCP
  • Community MCP Servers - รายการเซิร์ฟเวอร์ MCP ที่พัฒนาโดยชุมชนที่กำลังเติบโต
  • Awesome MCP Servers - รายการเซิร์ฟเวอร์ MCP ที่คัดสรร
  • PulseMCP - ศูนย์กลางชุมชนและจดหมายข่าวสำหรับค้นหาทรัพยากร MCP
  • Discord Server - เชื่อมต่อกับนักพัฒนา MCP
  • การใช้งาน SDK ตามภาษา
  • บทความและบทเรียน

การมีส่วนร่วมกับ MCP

ประเภทของการมีส่วนร่วม

ระบบนิเวศของ MCP ยินดีรับการสนับสนุนในหลายรูปแบบ:

  1. การสนับสนุนโค้ด:

    • การปรับปรุงโปรโตคอลหลัก
    • แก้ไขบั๊ก
    • การพัฒนาเครื่องมือและเซิร์ฟเวอร์
    • ไลบรารีลูกค้า/เซิร์ฟเวอร์ในภาษาต่าง ๆ
  2. เอกสาร:

    • ปรับปรุงเอกสารที่มีอยู่
    • สร้างบทเรียนและคู่มือ
    • แปลเอกสาร
    • สร้างตัวอย่างและแอปพลิเคชันตัวอย่าง
  3. การสนับสนุนชุมชน:

    • ตอบคำถามในฟอรัมและการสนทนา
    • ทดสอบและรายงานปัญหา
    • จัดกิจกรรมชุมชน
    • ให้คำปรึกษาผู้มีส่วนร่วมใหม่

กระบวนการมีส่วนร่วม: โปรโตคอลหลัก

หากต้องการสนับสนุนโปรโตคอลหลักของ MCP หรือการใช้งานอย่างเป็นทางการ ให้ปฏิบัติตามหลักการจาก แนวทางการมีส่วนร่วมอย่างเป็นทางการ:

  1. ความเรียบง่ายและความน้อยที่สุด: สเปค MCP ตั้งมาตรฐานสูงในการเพิ่มแนวคิดใหม่ การเพิ่มสิ่งใหม่ในสเปคง่ายกว่าการลบออก
  2. แนวทางที่ชัดเจน: การเปลี่ยนแปลงสเปคควรอิงจากปัญหาการใช้งานจริง ไม่ใช่แนวคิดที่คาดเดา
  3. ขั้นตอนของข้อเสนอ:
    • กำหนด: สำรวจปัญหาและยืนยันว่าผู้ใช้ MCP คนอื่น ๆ พบปัญหาเดียวกัน
    • สร้างต้นแบบ: สร้างตัวอย่างการแก้ปัญหาและแสดงการใช้งานจริง
    • เขียน: จากต้นแบบ เขียนข้อเสนอสำหรับสเปค

การตั้งค่าสภาพแวดล้อมการพัฒนา

# Fork the repository
git clone https://github.com/YOUR-USERNAME/modelcontextprotocol.git
cd modelcontextprotocol

# Install dependencies
npm install

# For schema changes, validate and generate schema.json:
npm run check:schema:ts
npm run generate:schema

# For documentation changes
npm run check:docs
npm run format

# Preview documentation locally (optional):
npm run serve:docs

ตัวอย่าง: การสนับสนุนการแก้ไขบั๊ก

// Original code with bug in the typescript-sdk
export function validateResource(resource: unknown): resource is MCPResource {
  if (!resource || typeof resource !== 'object') {
    return false;
  }
  
  // Bug: Missing property validation
  // Current implementation:
  const hasName = 'name' in resource;
  const hasSchema = 'schema' in resource;
  
  return hasName && hasSchema;
}

// Fixed implementation in a contribution
export function validateResource(resource: unknown): resource is MCPResource {
  if (!resource || typeof resource !== 'object') {
    return false;
  }
  
  // Improved validation
  const hasName = 'name' in resource && typeof (resource as MCPResource).name === 'string';
  const hasSchema = 'schema' in resource && typeof (resource as MCPResource).schema === 'object';
  const hasDescription = !('description' in resource) || typeof (resource as MCPResource).description === 'string';
  
  return hasName && hasSchema && hasDescription;
}

ตัวอย่าง: การสนับสนุนเครื่องมือใหม่ในไลบรารีมาตรฐาน

# Example contribution: A CSV data processing tool for the MCP standard library

from mcp_tools import Tool, ToolRequest, ToolResponse, ToolExecutionException
import pandas as pd
import io
import json
from typing import Dict, Any, List, Optional

class CsvProcessingTool(Tool):
    """
    Tool for processing and analyzing CSV data.
    
    This tool allows models to extract information from CSV files,
    run basic analysis, and convert data between formats.
    """
    
    def get_name(self):
        return "csvProcessor"
        
    def get_description(self):
        return "Processes and analyzes CSV data"
    
    def get_schema(self):
        return {
            "type": "object",
            "properties": {
                "csvData": {
                    "type": "string", 
                    "description": "CSV data as a string"
                },
                "csvUrl": {
                    "type": "string",
                    "description": "URL to a CSV file (alternative to csvData)"
                },
                "operation": {
                    "type": "string",
                    "enum": ["summary", "filter", "transform", "convert"],
                    "description": "Operation to perform on the CSV data"
                },
                "filterColumn": {
                    "type": "string",
                    "description": "Column to filter by (for filter operation)"
                },
                "filterValue": {
                    "type": "string",
                    "description": "Value to filter for (for filter operation)"
                },
                "outputFormat": {
                    "type": "string",
                    "enum": ["json", "csv", "markdown"],
                    "default": "json",
                    "description": "Output format for the processed data"
                }
            },
            "oneOf": [
                {"required": ["csvData", "operation"]},
                {"required": ["csvUrl", "operation"]}
            ]
        }
    
    async def execute_async(self, request: ToolRequest) -> ToolResponse:
        try:
            # Extract parameters
            operation = request.parameters.get("operation")
            output_format = request.parameters.get("outputFormat", "json")
            
            # Get CSV data from either direct data or URL
            df = await self._get_dataframe(request)
            
            # Process based on requested operation
            result = {}
            
            if operation == "summary":
                result = self._generate_summary(df)
            elif operation == "filter":
                column = request.parameters.get("filterColumn")
                value = request.parameters.get("filterValue")
                if not column:
                    raise ToolExecutionException("filterColumn is required for filter operation")
                result = self._filter_data(df, column, value)
            elif operation == "transform":
                result = self._transform_data(df, request.parameters)
            elif operation == "convert":
                result = self._convert_format(df, output_format)
            else:
                raise ToolExecutionException(f"Unknown operation: {operation}")
            
            return ToolResponse(result=result)
        
        except Exception as e:
            raise ToolExecutionException(f"CSV processing failed: {str(e)}")
    
    async def _get_dataframe(self, request: ToolRequest) -> pd.DataFrame:
        """Gets a pandas DataFrame from either CSV data or URL"""
        if "csvData" in request.parameters:
            csv_data = request.parameters.get("csvData")
            return pd.read_csv(io.StringIO(csv_data))
        elif "csvUrl" in request.parameters:
            csv_url = request.parameters.get("csvUrl")
            return pd.read_csv(csv_url)
        else:
            raise ToolExecutionException("Either csvData or csvUrl must be provided")
    
    def _generate_summary(self, df: pd.DataFrame) -> Dict[str, Any]:
        """Generates a summary of the CSV data"""
        return {
            "columns": df.columns.tolist(),
            "rowCount": len(df),
            "columnCount": len(df.columns),
            "numericColumns": df.select_dtypes(include=['number']).columns.tolist(),
            "categoricalColumns": df.select_dtypes(include=['object']).columns.tolist(),
            "sampleRows": json.loads(df.head(5).to_json(orient="records")),
            "statistics": json.loads(df.describe().to_json())
        }
    
    def _filter_data(self, df: pd.DataFrame, column: str, value: str) -> Dict[str, Any]:
        """Filters the DataFrame by a column value"""
        if column not in df.columns:
            raise ToolExecutionException(f"Column '{column}' not found")
            
        filtered_df = df[df[column].astype(str).str.contains(value)]
        
        return {
            "originalRowCount": len(df),
            "filteredRowCount": len(filtered_df),
            "data": json.loads(filtered_df.to_json(orient="records"))
        }
    
    def _transform_data(self, df: pd.DataFrame, params: Dict[str, Any]) -> Dict[str, Any]:
        """Transforms the data based on parameters"""
        # Implementation would include various transformations
        return {
            "status": "success",
            "message": "Transformation applied"
        }
    
    def _convert_format(self, df: pd.DataFrame, format: str) -> Dict[str, Any]:
        """Converts the DataFrame to different formats"""
        if format == "json":
            return {
                "data": json.loads(df.to_json(orient="records")),
                "format": "json"
            }
        elif format == "csv":
            return {
                "data": df.to_csv(index=False),
                "format": "csv"
            }
        elif format == "markdown":
            return {
                "data": df.to_markdown(),
                "format": "markdown"
            }
        else:
            raise ToolExecutionException(f"Unsupported output format: {format}")

แนวทางการสนับสนุน

เพื่อให้การสนับสนุนโครงการ MCP ประสบความสำเร็จ:

  1. เริ่มจากเล็ก ๆ: เริ่มจากเอกสาร แก้ไขบั๊ก หรือปรับปรุงเล็กน้อย
  2. ปฏิบัติตามแนวทางสไตล์: ยึดตามรูปแบบการเขียนโค้ดและข้อกำหนดของโครงการ
  3. เขียนการทดสอบ: รวมการทดสอบหน่วยสำหรับโค้ดของคุณ
  4. จัดทำเอกสารงานของคุณ: เพิ่มเอกสารที่ชัดเจนสำหรับฟีเจอร์หรือการเปลี่ยนแปลงใหม่
  5. ส่ง PR ที่เจาะจง: รักษาคำขอ pull request ให้เน้นเรื่องเดียวหรือฟีเจอร์เดียว
  6. ตอบรับความคิดเห็น: ตอบกลับและปรับปรุงตามคำแนะนำที่ได้รับ

ตัวอย่างกระบวนการสนับสนุน

# Clone the repository
git clone https://github.com/modelcontextprotocol/typescript-sdk.git
cd typescript-sdk

# Create a new branch for your contribution
git checkout -b feature/my-contribution

# Make your changes
# ...

# Run tests to ensure your changes don't break existing functionality
npm test

# Commit your changes with a descriptive message
git commit -am "Fix validation in resource handler"

# Push your branch to your fork
git push origin feature/my-contribution

# Create a pull request from your branch to the main repository
# Then engage with feedback and iterate on your PR as needed

การสร้างและแบ่งปันเซิร์ฟเวอร์ MCP

หนึ่งในวิธีที่มีคุณค่าที่สุดในการสนับสนุนระบบนิเวศ MCP คือการสร้างและแบ่งปันเซิร์ฟเวอร์ MCP ที่กำหนดเอง ชุมชนได้พัฒนาเซิร์ฟเวอร์หลายร้อยตัวสำหรับบริการและกรณีการใช้งานต่าง ๆ

กรอบงานพัฒนาเซิร์ฟเวอร์ MCP

มีกลุ่มกรอบงานหลายตัวที่ช่วยให้ง่ายต่อการพัฒนาเซิร์ฟเวอร์ MCP:

  1. SDK อย่างเป็นทางการ:

  2. กรอบงานของชุมชน:

    • MCP-Framework - สร้างเซิร์ฟเวอร์ MCP อย่างมีประสิทธิภาพและรวดเร็วด้วย TypeScript
    • MCP Declarative Java SDK - เซิร์ฟเวอร์ MCP แบบใช้ annotation ด้วย Java
    • Quarkus MCP Server SDK - กรอบงาน Java สำหรับเซิร์ฟเวอร์ MCP
    • Next.js MCP Server Template - โปรเจกต์เริ่มต้น Next.js สำหรับเซิร์ฟเวอร์ MCP

การพัฒนาเครื่องมือที่แชร์ได้

ตัวอย่าง .NET: การสร้างแพ็กเกจเครื่องมือที่แชร์ได้

// Create a new .NET library project
// dotnet new classlib -n McpFinanceTools

using Microsoft.Mcp.Tools;
using System.Threading.Tasks;
using System.Net.Http;
using System.Text.Json;

namespace McpFinanceTools
{
    // Stock quote tool
    public class StockQuoteTool : IMcpTool
    {
        private readonly HttpClient _httpClient;
        
        public StockQuoteTool(HttpClient httpClient = null)
        {
            _httpClient = httpClient ?? new HttpClient();
        }
        
        public string Name => "stockQuote";
        public string Description => "Gets current stock quotes for specified symbols";
        
        public object GetSchema()
        {
            return new {
                type = "object",
                properties = new {
                    symbol = new { 
                        type = "string",
                        description = "Stock symbol (e.g., MSFT, AAPL)" 
                    },
                    includeHistory = new { 
                        type = "boolean",
                        description = "Whether to include historical data",
                        default = false
                    }
                },
                required = new[] { "symbol" }
            };
        }
        
        public async Task<ToolResponse> ExecuteAsync(ToolRequest request)
        {
            // Extract parameters
            string symbol = request.Parameters.GetProperty("symbol").GetString();
            bool includeHistory = false;
            
            if (request.Parameters.TryGetProperty("includeHistory", out var historyProp))
            {
                includeHistory = historyProp.GetBoolean();
            }
            
            // Call external API (example)
            var quoteResult = await GetStockQuoteAsync(symbol);
            
            // Add historical data if requested
            if (includeHistory)
            {
                var historyData = await GetStockHistoryAsync(symbol);
                quoteResult.Add("history", historyData);
            }
            
            // Return formatted result
            return new ToolResponse {
                Result = JsonSerializer.SerializeToElement(quoteResult)
            };
        }
        
        private async Task<Dictionary<string, object>> GetStockQuoteAsync(string symbol)
        {
            // Implementation would call a real stock API
            // This is a simplified example
            return new Dictionary<string, object>
            {
                ["symbol"] = symbol,
                ["price"] = 123.45,
                ["change"] = 2.5,
                ["percentChange"] = 1.2,
                ["lastUpdated"] = DateTime.UtcNow
            };
        }
        
        private async Task<object> GetStockHistoryAsync(string symbol)
        {
            // Implementation would get historical data
            // Simplified example
            return new[]
            {
                new { date = DateTime.Now.AddDays(-7).Date, price = 120.25 },
                new { date = DateTime.Now.AddDays(-6).Date, price = 122.50 },
                new { date = DateTime.Now.AddDays(-5).Date, price = 121.75 }
                // More historical data...
            };
        }
    }
}

// Create package and publish to NuGet
// dotnet pack -c Release
// dotnet nuget push bin/Release/McpFinanceTools.1.0.0.nupkg -s https://api.nuget.org/v3/index.json -k YOUR_API_KEY

ตัวอย่าง Java: การสร้างแพ็กเกจ Maven สำหรับเครื่องมือ

// pom.xml configuration for a shareable MCP tool package
<!-- 
<project>
    <groupId>com.example</groupId>
    <artifactId>mcp-weather-tools</artifactId>
    <version>1.0.0</version>
    
    <dependencies>
        <dependency>
            <groupId>com.mcp</groupId>
            <artifactId>mcp-server</artifactId>
            <version>1.0.0</version>
        </dependency>
    </dependencies>
    
    <distributionManagement>
        <repository>
            <id>github</id>
            <name>GitHub Packages</name>
            <url>https://maven.pkg.github.com/username/mcp-weather-tools</url>
        </repository>
    </distributionManagement>
</project>
-->

package com.example.mcp.weather;

import com.mcp.tools.Tool;
import com.mcp.tools.ToolRequest;
import com.mcp.tools.ToolResponse;
import com.mcp.tools.ToolExecutionException;

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import java.util.HashMap;
import java.util.Map;

public class WeatherForecastTool implements Tool {
    private final HttpClient httpClient;
    private final String apiKey;
    
    public WeatherForecastTool(String apiKey) {
        this.httpClient = HttpClient.newHttpClient();
        this.apiKey = apiKey;
    }
    
    @Override
    public String getName() {
        return "weatherForecast";
    }
    
    @Override
    public String getDescription() {
        return "Gets weather forecast for a specified location";
    }
    
    @Override
    public Object getSchema() {
        Map<String, Object> schema = new HashMap<>();
        // Schema definition...
        return schema;
    }
    
    @Override
    public ToolResponse execute(ToolRequest request) {
        try {
            String location = request.getParameters().get("location").asText();
            int days = request.getParameters().has("days") ? 
                request.getParameters().get("days").asInt() : 3;
            
            // Call weather API
            Map<String, Object> forecast = getForecast(location, days);
            
            // Build response
            return new ToolResponse.Builder()
                .setResult(forecast)
                .build();
        } catch (Exception ex) {
            throw new ToolExecutionException("Weather forecast failed: " + ex.getMessage(), ex);
        }
    }
    
    private Map<String, Object> getForecast(String location, int days) {
        // Implementation would call weather API
        // Simplified example
        Map<String, Object> result = new HashMap<>();
        // Add forecast data...
        return result;
    }
}

// Build and publish using Maven
// mvn clean package
// mvn deploy

ตัวอย่าง Python: การเผยแพร่แพ็กเกจ PyPI

# Directory structure for a PyPI package:
# mcp_nlp_tools/
# ├── LICENSE
# ├── README.md
# ├── setup.py
# ├── mcp_nlp_tools/
# │   ├── __init__.py
# │   ├── sentiment_tool.py
# │   └── translation_tool.py

# Example setup.py
"""
from setuptools import setup, find_packages

setup(
    name="mcp_nlp_tools",
    version="0.1.0",
    packages=find_packages(),
    install_requires=[
        "mcp_server>=1.0.0",
        "transformers>=4.0.0",
        "torch>=1.8.0"
    ],
    author="Your Name",
    author_email="your.email@example.com",
    description="MCP tools for natural language processing tasks",
    long_description=open("README.md").read(),
    long_description_content_type="text/markdown",
    url="https://github.com/username/mcp_nlp_tools",
    classifiers=[
        "Programming Language :: Python :: 3",
        "License :: OSI Approved :: MIT License",
        "Operating System :: OS Independent",
    ],
    python_requires=">=3.8",
)
"""

# Example NLP tool implementation (sentiment_tool.py)
from mcp_tools import Tool, ToolRequest, ToolResponse, ToolExecutionException
from transformers import pipeline
import torch

class SentimentAnalysisTool(Tool):
    """MCP tool for sentiment analysis of text"""
    
    def __init__(self, model_name="distilbert-base-uncased-finetuned-sst-2-english"):
        # Load the sentiment analysis model
        self.sentiment_analyzer = pipeline("sentiment-analysis", model=model_name)
    
    def get_name(self):
        return "sentimentAnalysis"
        
    def get_description(self):
        return "Analyzes the sentiment of text, classifying it as positive or negative"
    
    def get_schema(self):
        return {
            "type": "object",
            "properties": {
                "text": {
                    "type": "string", 
                    "description": "The text to analyze for sentiment"
                },
                "includeScore": {
                    "type": "boolean",
                    "description": "Whether to include confidence scores",
                    "default": True
                }
            },
            "required": ["text"]
        }
    
    async def execute_async(self, request: ToolRequest) -> ToolResponse:
        try:
            # Extract parameters
            text = request.parameters.get("text")
            include_score = request.parameters.get("includeScore", True)
            
            # Analyze sentiment
            sentiment_result = self.sentiment_analyzer(text)[0]
            
            # Format result
            result = {
                "sentiment": sentiment_result["label"],
                "text": text
            }
            
            if include_score:
                result["score"] = sentiment_result["score"]
            
            # Return result
            return ToolResponse(result=result)
            
        except Exception as e:
            raise ToolExecutionException(f"Sentiment analysis failed: {str(e)}")

# To publish:
# python setup.py sdist bdist_wheel
# python -m twine upload dist/*

การแบ่งปันแนวทางปฏิบัติที่ดีที่สุด

เมื่อแบ่งปันเครื่องมือ MCP กับชุมชน:

  1. เอกสารครบถ้วน:

    • อธิบายวัตถุประสงค์ วิธีใช้ และตัวอย่าง
    • อธิบายพารามิเตอร์และค่าที่ส่งกลับ
    • ระบุการพึ่งพาภายนอกใด ๆ
  2. การจัดการข้อผิดพลาด:

    • มีการจัดการข้อผิดพลาดที่แข็งแรง
    • ให้ข้อความข้อผิดพลาดที่เป็นประโยชน์
    • จัดการกรณีขอบเขตอย่างเหมาะสม
  3. พิจารณาด้านประสิทธิภาพ:

    • ปรับให้เหมาะสมทั้งความเร็วและการใช้ทรัพยากร
    • ใช้การแคชเมื่อเหมาะสม
    • คำนึงถึงการขยายตัว
  4. ความปลอดภัย:

    • ใช้คีย์ API และการยืนยันตัวตนที่ปลอดภัย
    • ตรวจสอบและทำความสะอาดข้อมูลนำเข้า
    • จำกัดอัตราการเรียก API ภายนอก
  5. การทดสอบ:

    • รวมการทดสอบที่ครอบคลุม
    • ทดสอบกับข้อมูลนำเข้าหลากหลายและกรณีขอบเขต
    • จัดทำเอกสารขั้นตอนการทดสอบ

การทำงานร่วมกันในชุมชนและแนวทางปฏิบัติที่ดีที่สุด

ความร่วมมือที่มีประสิทธิภาพเป็นกุญแจสำคัญสู่ระบบนิเวศ MCP ที่เติบโต

ช่องทางการสื่อสาร

  • GitHub Issues และ Discussions
  • Microsoft Tech Community
  • ช่องทาง Discord และ Slack
  • Stack Overflow (แท็ก: model-context-protocol หรือ mcp)

การตรวจสอบโค้ด

เมื่อทำการตรวจสอบการสนับสนุน MCP:

  1. ความชัดเจน: โค้ดชัดเจนและมีเอกสารครบถ้วนหรือไม่?
  2. ความถูกต้อง: ทำงานได้ตามที่คาดหวังหรือไม่?
  3. ความสอดคล้อง: ปฏิบัติตามข้อกำหนดของโครงการหรือไม่?
  4. ความสมบูรณ์: มีการทดสอบและเอกสารประกอบหรือไม่?
  5. ความปลอดภัย: มีปัญหาด้านความปลอดภัยหรือไม่?

ความเข้ากันได้ของเวอร์ชัน

เมื่อพัฒนาสำหรับ MCP:

  1. การกำหนดเวอร์ชันโปรโตคอล: ปฏิบัติตามเวอร์ชันโปรโตคอล MCP ที่เครื่องมือของคุณรองรับ
  2. ความเข้ากันได้ของลูกค้า: พิจารณาความเข้ากันได้ย้อนหลัง
  3. ความเข้ากันได้ของเซิร์ฟเวอร์: ปฏิบัติตามแนวทางการใช้งานเซิร์ฟเวอร์
  4. การเปลี่ยนแปลงที่ทำให้เกิดปัญหา: ระบุอย่างชัดเจนหากมีการเปลี่ยนแปลงที่ทำให้เกิดปัญหา

ตัวอย่างโครงการชุมชน: MCP Tool Registry

การสนับสนุนที่สำคัญในชุมชนอาจเป็นการพัฒนาระบบทะเบียนสาธารณะสำหรับเครื่องมือ MCP

# Example schema for a community tool registry API

from fastapi import FastAPI, HTTPException, Depends
from pydantic import BaseModel, Field, HttpUrl
from typing import List, Optional
import datetime
import uuid

# Models for the tool registry
class ToolSchema(BaseModel):
    """JSON Schema for a tool"""
    type: str
    properties: dict
    required: List[str] = []

class ToolRegistration(BaseModel):
    """Information for registering a tool"""
    name: str = Field(..., description="Unique name for the tool")
    description: str = Field(..., description="Description of what the tool does")
    version: str = Field(..., description="Semantic version of the tool")
    schema: ToolSchema = Field(..., description="JSON Schema for tool parameters")
    author: str = Field(..., description="Author of the tool")
    repository: Optional[HttpUrl] = Field(None, description="Repository URL")
    documentation: Optional[HttpUrl] = Field(None, description="Documentation URL")
    package: Optional[HttpUrl] = Field(None, description="Package URL")
    tags: List[str] = Field(default_factory=list, description="Tags for categorization")
    examples: List[dict] = Field(default_factory=list, description="Example usage")

class Tool(ToolRegistration):
    """Tool with registry metadata"""
    id: uuid.UUID = Field(default_factory=uuid.uuid4)
    created_at: datetime.datetime = Field(default_factory=datetime.datetime.now)
    updated_at: datetime.datetime = Field(default_factory=datetime.datetime.now)
    downloads: int = Field(default=0)
    rating: float = Field(default=0.0)
    ratings_count: int = Field(default=0)

# FastAPI application for the registry
app = FastAPI(title="MCP Tool Registry")

# In-memory database for this example
tools_db = {}

@app.post("/tools", response_model=Tool)
async def register_tool(tool: ToolRegistration):
    """Register a new tool in the registry"""
    if tool.name in tools_db:
        raise HTTPException(status_code=400, detail=f"Tool '{tool.name}' already exists")
    
    new_tool = Tool(**tool.dict())
    tools_db[tool.name] = new_tool
    return new_tool

@app.get("/tools", response_model=List[Tool])
async def list_tools(tag: Optional[str] = None):
    """List all registered tools, optionally filtered by tag"""
    if tag:
        return [tool for tool in tools_db.values() if tag in tool.tags]
    return list(tools_db.values())

@app.get("/tools/{tool_name}", response_model=Tool)
async def get_tool(tool_name: str):
    """Get information about a specific tool"""
    if tool_name not in tools_db:
        raise HTTPException(status_code=404, detail=f"Tool '{tool_name}' not found")
    return tools_db[tool_name]

@app.delete("/tools/{tool_name}")
async def delete_tool(tool_name: str):
    """Delete a tool from the registry"""
    if tool_name not in tools_db:
        raise HTTPException(status_code=404, detail=f"Tool '{tool_name}' not found")
    del tools_db[tool_name]
    return {"message": f"Tool '{tool_name}' deleted"}

สรุปประเด็นสำคัญ

  • ชุมชน MCP มีความหลากหลายและยินดีรับการสนับสนุนในหลายรูปแบบ
  • การสนับสนุน MCP ครอบคลุมตั้งแต่การปรับปรุงโปรโตคอลหลักจนถึงเครื่องมือที่กำหนดเอง
  • การปฏิบัติตามแนวทางการสนับสนุนช่วยเพิ่มโอกาสที่ PR ของคุณจะได้รับการยอมรับ
  • การสร้างและแบ่งปันเครื่องมือ MCP เป็นวิธีที่มีคุณค่าในการพัฒนาระบบนิเวศ
  • ความร่วมมือในชุมชนเป็นสิ่งจำเป็นสำหรับการเติบโตและพัฒนา MCP

แบบฝึกหัด

  1. ระบุพื้นที่ในระบบนิเวศ MCP ที่คุณสามารถมีส่วนร่วมตามทักษะและความสนใจของคุณ
  2. Fork ที่เก็บ MCP และตั้งค่าสภาพแวดล้อมการพัฒนาในเครื่องของคุณ
  3. สร้างการปรับปรุงเล็ก ๆ แก้ไขบั๊ก หรือเครื่องมือที่เป็นประโยชน์ต่อชุมชน
  4. จัดทำเอกสารการสนับสนุนพร้อมการทดสอบที่เหมาะสม
  5. ส่ง pull request ไปยังที่เก็บที่เหมาะสม

ทรัพยากรเพิ่มเติม


ถัดไป: บทเรียนจากการนำไปใช้ในช่วงแรก

ข้อจำกัดความรับผิดชอบ:
เอกสารนี้ได้รับการแปลโดยใช้บริการแปลภาษาอัตโนมัติ Co-op Translator แม้เราจะพยายามให้ความถูกต้องสูงสุด แต่โปรดทราบว่าการแปลอัตโนมัติอาจมีข้อผิดพลาดหรือความไม่ถูกต้อง เอกสารต้นฉบับในภาษาต้นทางถือเป็นแหล่งข้อมูลที่เชื่อถือได้ สำหรับข้อมูลที่สำคัญ ขอแนะนำให้ใช้บริการแปลโดยผู้เชี่ยวชาญมนุษย์ เราไม่รับผิดชอบต่อความเข้าใจผิดหรือการตีความผิดใด ๆ ที่เกิดจากการใช้การแปลนี้