Skip to content

Latest commit

 

History

History
851 lines (681 loc) · 44.4 KB

File metadata and controls

851 lines (681 loc) · 44.4 KB

समुदाय र योगदानहरू

MCP मा कसरी योगदान गर्ने: उपकरणहरू, कागजातहरू, कोड र थप

(यो पाठको भिडियो हेर्न माथिको तस्बिरमा क्लिक गर्नुहोस्)

अवलोकन

यस पाठले 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 क्लाइन्टहरू - MCP समायोजनहरू समर्थन गर्ने क्लाइन्टहरूको सूची
  • समुदाय MCP सर्भरहरू - समुदायद्वारा विकास गरिएको MCP सर्भरहरूको वृद्धिशील सूची
  • अद्भुत MCP सर्भरहरू - चयनित MCP सर्भरहरूको सूची
  • PulseMCP - MCP स्रोतहरू पत्ता लगाउनको लागि समुदाय समुह र न्यूजलेटर
  • Discord सर्भर - MCP विकासकर्ताहरूसँग जडान हुन
  • भाषा-विशिष्ट SDK कार्यान्वयनहरू
  • ब्लग पोष्टहरू र ट्यूटोरियलहरू

MCP मा योगदान गर्नुहोस्

योगदानका प्रकारहरू

MCP पारिस्थितिकी तंत्र विभिन्न प्रकारका योगदानहरूलाई स्वागत गर्दछ:

  1. कोड योगदानहरू:

    • कोर प्रोटोकल सुधारहरू
    • बग सुधारहरू
    • उपकरण र सर्भर कार्यान्वयनहरू
    • विभिन्न भाषाहरूमा क्लाइन्ट/सर्भर लाइब्रेरीहरू
  2. कागजातहरू:

    • अवस्थित कागजात सुधार्न
    • ट्यूटोरियल र गाइडहरू सिर्जना गर्न
    • कागजात अनुवाद गर्न
    • उदाहरणहरू र नमूना अनुप्रयोगहरू सिर्जना गर्न
  3. समुदाय समर्थन:

    • फोरम र छलफलमा प्रश्नहरूको जवाफ दिन
    • परीक्षण र समस्या रिपोर्टिंग
    • समुदाय कार्यक्रमहरू आयोजना गर्न
    • नयाँ योगदानकर्ताहरूसँग मार्गदर्शन गर्न

योगदान प्रक्रिया: कोर प्रोटोकल

कोर MCP प्रोटोकल वा आधिकारिक कार्यान्वयनहरूमा योगदान गर्न, आधिकारिक योगदान निर्देशनहरू बाट यी सिद्धान्तहरू पालना गर्नुहोस्:

  1. सरलता र न्यूनतावाद: MCP विशिष्टताले नयाँ अवधारणा थप्न उच्च मापदण्ड राख्छ। कुनै वस्तु थप्न सजिलो हुन्छ भन्दा त्यसलाई हटाउन।

  2. व्यावहारिक दृष्टिकोण: विशिष्टतामा परिवर्तनहरू विशिष्ट कार्यान्वयन चुनौतीहरूमा आधारित हुनुपर्छ, कल्पनाशील विचारहरूमा होइन।

  3. प्रस्तावका चरणहरू:

    • परिभाषा: समस्या क्षेत्र अन्वेषण गर्नुहोस्, सम्झनुहोस् कि अन्य MCP प्रयोगकर्ताहरूले पनि समान समस्या भोगिरहेका छन्
    • प्रोटोटाइप: उदाहरण समाधान तयार गर्नुहोस् र यसको व्यवहारिक प्रयोग देखाउनुहोस्
    • लेखन: प्रोटोटाइपको आधारमा विशिष्टता प्रस्ताव लेख्नुहोस्

विकास वातावरण सेटअप

# रिपोजिटरी फोर्क गर्नुहोस्
git clone https://github.com/YOUR-USERNAME/modelcontextprotocol.git
cd modelcontextprotocol

# निर्भरताहरू स्थापना गर्नुहोस्
npm install

# स्कीमा परिवर्तनहरूको लागि, मान्यकरण गर्नुहोस् र schema.json सिर्जना गर्नुहोस्:
npm run check:schema:ts
npm run generate:schema

# डकुमेन्टेसन परिवर्तनहरूको लागि
npm run check:docs
npm run format

# स्थानीय रूपमा डकुमेन्टेसन पूर्वावलोकन गर्नुहोस् (वैकल्पिक):
npm run serve:docs

उदाहरण: बग सुधारमा योगदान

// typescript-sdk मा बग सहितको मूल कोड
export function validateResource(resource: unknown): resource is MCPResource {
  if (!resource || typeof resource !== 'object') {
    return false;
  }
  
  // बग: सम्पत्ति प्रमाणीकरण हराइरहेको
  // वर्तमान कार्यान्वयन:
  const hasName = 'name' in resource;
  const hasSchema = 'schema' in resource;
  
  return hasName && hasSchema;
}

// योगदानमा सुधारिएको कार्यान्वयन
export function validateResource(resource: unknown): resource is MCPResource {
  if (!resource || typeof resource !== 'object') {
    return false;
  }
  
  // सुधारिएको प्रमाणीकरण
  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;
}

उदाहरण: मानक लाइब्रेरीमा नयाँ उपकरण योगदान

# उदाहरण योगदान: MCP स्ट्यान्डर्ड लाइब्रेरीको लागि CSV डाटा प्रशोधन उपकरण

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:
            # प्यारामिटरहरू निकाल्नुहोस्
            operation = request.parameters.get("operation")
            output_format = request.parameters.get("outputFormat", "json")
            
            # सोझै डाटा वा URL बाट CSV डाटा प्राप्त गर्नुहोस्
            df = await self._get_dataframe(request)
            
            # अनुरोधित अपरेसनको आधारमा प्रशोधन गर्नुहोस्
            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"""
        # कार्यान्वयनमा विभिन्न रूपान्तरणहरू समावेश हुनेछन्
        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 हरू पेश गर्नुहोस्: पुल अनुरोधहरूलाई एकै समस्या वा सुविधामा केन्द्रित राख्नुहोस्
  6. प्रतिक्रियासँग संलग्न हुनुहोस्: आफ्नो योगदानहरूमा प्रतिक्रिया प्राप्त गर्न संवेदनशील हुनुहोस्

उदाहरण योगदान कार्यप्रवाह

# रिपोजिटरी क्लोन गर्नुहोस्
git clone https://github.com/modelcontextprotocol/typescript-sdk.git
cd typescript-sdk

# तपाईंको योगदानका लागि नयाँ शाखा सिर्जना गर्नुहोस्
git checkout -b feature/my-contribution

# तपाईंका परिवर्तनहरू गर्नुहोस्
# ...

# परीक्षणहरू चलाउनुहोस् ताकि तपाईंका परिवर्तनहरूले विद्यमान कार्यक्षमतामा असर नपारोस्
npm test

# वर्णनात्मक सन्देशसहित तपाईंका परिवर्तनहरू कमिट गर्नुहोस्
git commit -am "Fix validation in resource handler"

# तपाईंको शाखालाई तपाईंको फोर्कमा पुश गर्नुहोस्
git push origin feature/my-contribution

# मुख्य रिपोजिटरीमा तपाईंको शाखाबाट पुल रिक्वेस्ट सिर्जना गर्नुहोस्
# त्यसपछि प्रतिक्रिया लिनुहोस् र आवश्यक अनुसार तपाईंको PR मा सुधार गर्नुहोस्

MCP सर्भरहरू सिर्जना र साझेदारी

MCP पारिस्थितिकी तंत्रमा योगदान गर्ने सबैभन्दा मूल्यवान तरिकाहरू मध्ये एक हो कस्टम MCP सर्भरहरू सिर्जना र साझेदारी गर्नु। समुदायले पहिले नै विभिन्न सेवाहरू र प्रयोगका लागि सयौं सर्भरहरू विकास गरिसकेको छ।

MCP सर्भर विकास फ्रेमवर्कहरू

थप सहज बनाउनका लागि MCP सर्भर विकासका लागि विभिन्न फ्रेमवर्कहरू उपलब्ध छन्:

  1. आधिकारिक SDK हरू (MCP विशिष्टता 2025-11-25 अनुरूप):

  2. समुदाय फ्रेमवर्कहरू:

    • MCP-Framework - TypeScript मा MCP सर्भरहरू छरितो र छिटो बनाउन
    • MCP Declarative Java SDK - Java संग एनोटेशन-आधारित MCP सर्भरहरू
    • Quarkus MCP Server SDK - MCP सर्भरहरूको लागि Java फ्रेमवर्क
    • Next.js MCP Server Template - MCP सर्भरहरूको लागि सुरूवाती Next.js परियोजना

साझेदारी योग्य उपकरणहरूको विकास

.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 प्याकेज सिर्जना

// साझेदारीयोग्य MCP उपकरण प्याकेजको लागि pom.xml कन्फिगरेसन
<!-- 
<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<>();
        // स्किमाको परिभाषा...
        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;
            
            // मौसम API कल गर्नुहोस्
            Map<String, Object> forecast = getForecast(location, days);
            
            // प्रतिक्रिया बनाउनुहोस्
            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) {
        // कार्यान्वयनले मौसम API कल गर्नेछ
        // सरलीकृत उदाहरण
        Map<String, Object> result = new HashMap<>();
        // पूर्वानुमान डेटा थप्नुहोस्...
        return result;
    }
}

// Maven प्रयोग गरी निर्माण र प्रकाशन गर्नुहोस्
// mvn clean package
// mvn deploy

Python उदाहरण: PyPI प्याकेज प्रकाशन

# PyPI प्याकेजको लागि डायरेक्टरी संरचना:
# mcp_nlp_tools/
# ├── LICENSE
# ├── README.md
# ├── setup.py
# ├── mcp_nlp_tools/
# │   ├── __init__.py
# │   ├── sentiment_tool.py
# │   └── translation_tool.py

# उदाहरण 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",
)
"""

# उदाहरण NLP उपकरण कार्यान्वयन (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"):
        # भावना विश्लेषण मोडेल लोड गर्नुहोस्
        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:
            # प्यारामीटरहरू निकाल्नुहोस्
            text = request.parameters.get("text")
            include_score = request.parameters.get("includeScore", True)
            
            # भावना विश्लेषण गर्नुहोस्
            sentiment_result = self.sentiment_analyzer(text)[0]
            
            # परिणाम स्वरूप गर्नुहोस्
            result = {
                "sentiment": sentiment_result["label"],
                "text": text
            }
            
            if include_score:
                result["score"] = sentiment_result["score"]
            
            # परिणाम फर्काउनुहोस्
            return ToolResponse(result=result)
            
        except Exception as e:
            raise ToolExecutionException(f"Sentiment analysis failed: {str(e)}")

# प्रकाशन गर्न:
# python setup.py sdist bdist_wheel
# python -m twine upload dist/*

उत्तम अभ्यासहरू साझेदारी गर्नुहोस्

समुदायसँग MCP उपकरणहरू साझेदारी गर्दा:

  1. पूर्ण कागजात:

    • उद्देश्य, प्रयोग, र उदाहरणहरू कागजात गर्नुहोस्
    • प्यारामिटरहरू र परिणामहरू व्याख्या गर्नुहोस्
    • कुनै बाह्य निर्भरता उल्लेख गर्नुहोस्
  2. त्रुटि व्यवस्थापन:

    • सुदृढ त्रुटि व्यवस्थापन कार्यान्वयन गर्नुहोस्
    • उपयोगी त्रुटि सन्देशहरू प्रदान गर्नुहोस्
    • किनारका अवस्थामा राम्रोसँग व्यवहार गर्नुहोस्
  3. प्रदर्शन सम्बन्धी विचारहरू:

    • द्रुतता र स्रोत उपभोग दुवैमा सुधार गर्नुहोस्
    • उपयुक्त अवस्थामा क्यासिङ कार्यान्वयन गर्नुहोस्
    • स्केलेबिलिटी विचार गर्नुहोस्
  4. सुरक्षा:

    • सुरक्षित API कुञ्जीहरू र प्रमाणीकरण प्रयोग गर्नुहोस्
    • इनपुटहरू मान्य र सफा गर्नुहोस्
    • बाह्य API कलहरूको लागि दर सिमांकन कार्यान्वयन गर्नुहोस्
  5. परीक्षण:

    • व्यापक परीक्षण कभरज समावेश गर्नुहोस्
    • विभिन्न इनपुट प्रकार र किनार अवस्था परीक्षण गर्नुहोस्
    • परीक्षण प्रक्रियाहरू कागजात गर्नुहोस्

समुदाय सहकार्य र उत्तम अभ्यासहरू

प्रभावकारी सहकार्य एक समृद्ध MCP पारिस्थितिकी तंत्रका लागि अत्यावश्यक छ।

सञ्चार च्यानलहरू

  • GitHub मुद्दाहरू र छलफलहरू
  • Microsoft टेक समुदाय
  • Discord र Slack च्यानलहरू
  • Stack Overflow (model-context-protocol वा mcp ट्यागका साथ)

कोड समीक्षा

MCP योगदानहरू समीक्षा गर्दा:

  1. स्पष्टता: कोड स्पष्ट र राम्रो कागजात गरिएको छ?
  2. सहीता: के यो आशा अनुसार काम गर्छ?
  3. एकरूपता: के यो परियोजना परम्पराहरू अनुसरण गर्दछ?
  4. पूर्णता: परीक्षण र कागजातहरू समावेश छन्?
  5. सुरक्षा: के कुनै सुरक्षा चिन्ताहरू छन्?

संस्करण अनुकूलता

MCP को लागि विकास गर्दा:

  1. प्रोटोकल संस्करण: आफ्नो उपकरणले समर्थन गर्ने MCP प्रोटोकल संस्करण पालना गर्नुहोस्
  2. क्लाइन्ट अनुकूलता: पछाडि अनुकूलता अवलोकन गर्नुहोस्
  3. सर्भर अनुकूलता: सर्भर कार्यान्वयन निर्देशनहरू अनुसरण गर्नुहोस्
  4. भङ्ग गर्ने परिवर्तनहरू: कुनै पनि भङ्ग गर्ने परिवर्तनहरू स्पष्ट रूपमा कागजात गर्नुहोस्

उदाहरण समुदाय परियोजना: MCP उपकरण रजिष्ट्रि

महत्वपूर्ण समुदाय योगदान MCP उपकरणहरूको सार्वजनिक रजिष्ट्रि विकास गर्न सक्छ।

# समुदाय उपकरण रजिस्ट्री API का लागि उदाहरण योजना

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

# उपकरण रजिस्ट्रीका लागि मोडेलहरू
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 अनुप्रयोग
app = FastAPI(title="MCP Tool Registry")

# यस उदाहरणका लागि इन-मेमोरी डाटाबेस
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. MCP रिपोजिटोरीलाई फोर्क गरी स्थानीय विकास वातावरण सेटअप गर्नुहोस्
  3. समुदायलाई लाभ हुने सानो सुधार, बग सुधार, वा उपकरण सिर्जना गर्नुहोस्
  4. आफ्नो योगदानलाई उपयुक्त परीक्षण र कागजातसँग दस्तावेजीकरण गर्नुहोस्
  5. उपयुक्त रिपोजिटोरीमा पुल अनुरोध (PR) पेश गर्नुहोस्

थप स्रोतहरू


अर्को के छ

अर्को: पहिलो अपनत्वका पाठहरू


अस्वीकरण: यस दस्तावेजलाई AI अनुवाद सेवा Co-op Translator प्रयोग गरी अनुवाद गरिएको हो। हामी शुद्धताको प्रयास गर्छौं, तर कृपया ध्यान दिनुहोस् कि स्वचालित अनुवादमा त्रुटि वा गलतिय हुन सक्दछन्। मूल दस्तावेज यसको मातृ भाषामा नै अधिकारिक स्रोत मानिनुपर्छ। महत्वपूर्ण जानकारीको लागि पेशेवर मानव अनुवाद सिफारिस गरिन्छ। यस अनुवादको प्रयोगबाट उत्पन्न कुनै पनि गलतफहमी वा गलत व्याख्याका लागि हामी जिम्मेवार छैनौं।