OSSInsight MCP Server

Instructions

Implementation Reference

• index.ts:120-181 (handler)

  Core handler function that performs the repository analysis by querying the OSSInsight API or falling back to web scraping.
  async function getRepoAnalysis(ownerRepo: string, timePeriod?: string): Promise<any> { const [owner, repo] = ownerRepo.split('/'); if (!owner || !repo) { throw new Error('Invalid repository format. Use "owner/repo"'); } try { // Get repository basic info from API const repoResponse = await apiRequest(`/repo/${owner}/${repo}`) as ApiResponse; // Extract data from response structure (which matches repo.json) const repoData = (repoResponse['data'] || repoResponse) as RepositoryData; // Create a structured response with the available data const analysis = { basic_info: { name: repoData.name, full_name: repoData.full_name, description: repoData.description, html_url: repoData.html_url, homepage: repoData.homepage, created_at: repoData.created_at, updated_at: repoData.updated_at, language: repoData.language, license: repoData.license, topics: repoData.topics }, statistics: { stars: repoData.stargazers_count, watchers: repoData.watchers_count, forks: repoData.forks_count, open_issues: repoData.open_issues_count, size: repoData.size }, owner: { login: repoData.owner?.login, type: repoData.owner?.type, html_url: repoData.owner?.html_url, avatar_url: repoData.owner?.avatar_url }, web_url: `${OSSINSIGHT_WEB_URL}/analyze/${owner}/${repo}` }; return analysis; } catch (error) { // If API fails, try to extract data from the web page console.error(`API request failed, falling back to web scraping: ${error}`); const webUrl = `${OSSINSIGHT_WEB_URL}/analyze/${owner}/${repo}`; return { message: "API request failed. Falling back to web scraping.", web_data: await scrapeOSSInsightPage(webUrl, { title: 'h1', stars: '.stars-count', forks: '.forks-count', open_issues: '.issues-count', // Add more selectors as needed }), web_url: webUrl }; } }
• schemas.ts:4-8 (schema)

  Zod schema defining the input parameters for the get_repo_analysis tool.
  export const GetRepoAnalysisParamsSchema = z.object({ owner_repo: z.string().describe("Repository name in the format 'owner/repo'"), time_period: z.enum(['last_28_days', 'last_90_days', 'last_year', 'all_time']).optional() .describe("Time range for analysis (optional)") });
• index.ts:288-291 (registration)

  Registration of the tool in the list of available tools returned by ListToolsRequest.
  name: "get_repo_analysis", description: "Get detailed analysis of a GitHub repository, including activity, stars, issues, and other metrics.", inputSchema: zodToJsonSchema(GetRepoAnalysisParamsSchema) },
• index.ts:324-328 (handler)

  Dispatch handler in CallToolRequestSchema that parses arguments and invokes the getRepoAnalysis function.
  case "get_repo_analysis": { const args = GetRepoAnalysisParamsSchema.parse(request.params.arguments); const analysis = await getRepoAnalysis(args.owner_repo, args.time_period); return { content: [{ type: "text", text: JSON.stringify(analysis, null, 2) }] }; }
• index.ts:35-60 (helper)

  Helper function for making API requests to OSSInsight, used by the getRepoAnalysis handler.
  async function apiRequest(endpoint: string, params: Record<string, any> = {}, useRepoApi: boolean = true) { // Build URL and query parameters const baseUrl = useRepoApi ? OSSINSIGHT_REPO_API_URL : OSSINSIGHT_API_URL; const url = new URL(`${baseUrl}${endpoint}`); // Add query parameters Object.entries(params).forEach(([key, value]) => { if (value !== undefined) { url.searchParams.append(key, String(value)); } }); // Send request const response = await fetch(url.toString(), { headers: { "Accept": "application/json" } }); if (!response.ok) { const errorText = await response.text(); throw new Error(`OSSInsight API error: ${response.status} ${response.statusText}\n${errorText}`); } return response.json(); }