Servidor MCP

MSPortfolio — MCP-Native Engineering Portfolio

io.github.ManSio/msp-portfolio

Qué hace este MCP

Exposes an engineer's portfolio, projects, commits, articles, principles, experiments, issues, and architecture simulations, with tools for verifying related claims and repositories.

analyze_stack
Compare the owner's stack against a job's required skills. Returns per-skill match with evidence and coverage.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['required_skills'], 'properties': {'required_skills': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Skills the job requires.'}}, 'additionalProperties': {}}
get_antipatterns
Get the owner's antipattern museum — real engineering mistakes with why they were bad, how they were fixed, and the lesson. Read-only, closed world.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': {}}
get_articles
Get recent Dev.to articles with reading time, tags and links.
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': {}}
get_commit_history
Get recent commit history across the owner's public repos. Reads the deployed snapshot and reports its `fetchedAt` and `ageMinutes`, so 'how current is this?' is answered by the payload instead of by trusting this description. Use it to answer 'what has he been building lately' or 'show the hardest bugs he has fixed'.
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': {}}
get_diary
Get the owner's engineering diary — incidents, root causes, fixes and guards, each tagged with a pattern (NEW vs recurring). Use it to answer 'what broke and how did you fix it' or 'show your hardest debugging session'. Read-only, closed world.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': {}}
get_engineering_principles
Get engineering principles with real examples and A/B-style counterfactuals.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': {}}
get_experiments
Get the owner's engineering experiments — hypothesis, command, raw result and verdict (confirmed/refuted/partial) for each. Use it to answer 'what did you measure' or 'show me an experiment you ran'. Includes negative results (approaches that failed). Read-only, closed world.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': {}}
get_issue_detail
Get the full detail of a single known issue by its ID (e.g. 'KI-109'). Drills into one open problem: status, temperature, owner, linked source and the raw problem statement. Returns a clear not-found with the available IDs if the ID does not match. Read-only, closed world.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': "The issue ID, e.g. 'KI-109' (case-insensitive)."}}, 'additionalProperties': {}}
get_known_issues
Get the owner's known-issues board — open debt with status, temperature (stable/watching) and deadlines. Use it to answer 'what's still broken' or 'what are you working on'. Read-only, closed world.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': {}}
get_profile
Get the owner's professional profile summary, plus nextSteps — concrete ways to continue (contact channels, GitHub, MCP connect). Use it as the first tool in an interview.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': {}}
get_projects
Get portfolio projects with stack, highlights, and decision logs. Optional filter by stack tag.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'filter': {'enum': ['all', 'python', 'typescript', 'mcp', 'aws', 'ai'], 'type': 'string', 'description': 'Filter projects by stack tag.'}}, 'additionalProperties': {}}
get_timeline
Get the engineering decision timeline.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': {}}
search_projects
Free-text search across portfolio projects — name, tagline, description, stack and decision-log rationale. Returns matched projects with a score and the fields that matched. Use when a fixed stack-tag filter is too narrow (e.g. 'RAG', 'latency', 'Zed'). Read-only, closed world.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': "Search terms, e.g. 'RAG' or 'latency Zed'."}}, 'additionalProperties': {}}
simulate_architecture
Simulate how a project's architecture behaves under a scenario (load spike, node loss, cache cold, LLM saturation). Returns latency percentiles per load and bottleneck analysis.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['project_id', 'scenario'], 'properties': {'scenario': {'enum': ['load_spike', 'node_loss', 'cache_cold', 'llm_saturation'], 'type': 'string', 'description': 'Scenario to apply.'}, 'project_id': {'enum': ['mscodebase-intelligence', 'gemma_agent', 'msp-portfolio'], 'type': 'string', 'description': 'Project to simulate.'}}, 'additionalProperties': {}}
verify_article
Verify an article against the primary source (Dev.to): does the owner have a published article matching the query? Fetches the live Dev.to API for the owner's articles and returns the real title/date/reactions/url when found — or an honest 'not found'. Use it to ground claims like 'he wrote about agent memory' in the platform's data instead of the portfolio's own words. Read-only, open world (network fetch).
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'Article title fragment or keyword, e.g. "agent memory" or an exact title.'}}, 'additionalProperties': {}}
verify_claim
Ground a claim about the owner against the portfolio's data (profile, projects, principles, timeline, antipatterns, experiments, diary, known issues). Deterministic: returns the evidence records that support the claim (with source paths) and a supported verdict. Use it before asserting a fact about the owner, or to check what an answer was based on.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['claim'], 'properties': {'claim': {'type': 'string', 'description': 'The claim to verify, e.g. "built an MCP server with LanceDB hybrid search".'}}, 'additionalProperties': {}}
verify_package
Verify an npm package against the primary source (registry.npmjs.org): does it exist, latest version, publish date, description, license, maintainers — and is the owner among them? Use it to ground claims like 'he published an npm package' in the registry's data instead of the portfolio's. Honest 'not found' when the package does not exist. Read-only, open world (network fetch).
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['package'], 'properties': {'package': {'type': 'string', 'description': 'npm package name, e.g. "msp-portfolio" (lowercase).'}}, 'additionalProperties': {}}
verify_repo
Verify a GitHub repository against the primary source: fetches the actual repo metadata (exists, language, description, topics, stars, last push) from the GitHub API and cross-checks it with the portfolio's project record when the repo is one of the owner's projects (language/stack agreement). With readme:true it also returns the actual README text, so claims about what the project does can be checked against the repository's own words. Use it to ground claims like 'the repo is Python' or 'he maintains mscodebase-intelligence' with live data instead of trusting the claim. Read-only, open world (network fetch).
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['repo'], 'properties': {'repo': {'type': 'string', 'description': 'Repository name, e.g. "mscodebase-intelligence" (owner defaults to ManSio) or full "owner/name" or a github.com URL.'}, 'readme': {'type': 'boolean', 'description': "Also fetch the repository README (first ~1200 chars) for claim checks against the project's own description."}}, 'additionalProperties': {}}
Modificado
get_commit_history
1 de October de 2026 a las 02:46
Añadido
verify_package
17 de September de 2026 a las 12:43
Añadido
verify_article
17 de September de 2026 a las 12:43
Añadido
verify_repo
17 de September de 2026 a las 12:43
Añadido
verify_claim
17 de September de 2026 a las 12:43
Añadido
get_issue_detail
17 de September de 2026 a las 12:43
Añadido
get_known_issues
17 de September de 2026 a las 12:43
Añadido
get_diary
17 de September de 2026 a las 12:43
Añadido
get_experiments
17 de September de 2026 a las 12:43
Añadido
simulate_architecture
17 de September de 2026 a las 12:43
Añadido
analyze_stack
17 de September de 2026 a las 12:43
Añadido
get_antipatterns
17 de September de 2026 a las 12:43
Añadido
get_commit_history
17 de September de 2026 a las 12:43
Añadido
get_articles
17 de September de 2026 a las 12:43
Añadido
get_timeline
17 de September de 2026 a las 12:43
Añadido
get_engineering_principles
17 de September de 2026 a las 12:43
Añadido
search_projects
17 de September de 2026 a las 12:43
Añadido
get_projects
17 de September de 2026 a las 12:43
Añadido
get_profile
17 de September de 2026 a las 12:43