MCP, MCP server
Mcp Portfolio
A hands-on portfolio of three Model Context Protocol (MCP) servers, each built from scratch with the MCP Python SDK v2 to demonstrate a different integration pattern an AI agent needs in the real world: talking to a public REST API, safely q
Compatibility: Not stated.
Grade B
Minor issues only, no Medium or High. Worth a quick look at the findings below before installing.
Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.
NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV SECRETS_ENV_READ
Why this grade
- NETWORK_NO_FIXED_HOST Low
Makes a network call whose host is not written as a fixed address.
01-github-mcp-server/server.py, line 122
response = requests.get( - SECRETS_PATH_DOTENV Low
Mentions a .env file.
01-github-mcp-server/README.md, line 22
Repeat for `client_demo.py`, `tests/test_server.py` (create the `tests/` folder first with `!mkdir -p tests`), `requirements.txt`, `.env.example`, and `.gitignore`. - SECRETS_ENV_READ Note
Reads an environment variable whose name contains KEY, SECRET, TOKEN, PASSWORD or CREDENTIAL.
01-github-mcp-server/server.py, line 107
token = os.getenv("GITHUB_TOKEN")
Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.
Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.
What was checked
Plain notes from the hygiene checks.
Permissions
Pass
No shell or command execution found, and no extra permission was declared.
Install and update
Pass
No install-time script found, and dependencies are pinned or absent.
Network
Concern
can reach a host that is not written as a fixed address.
NETWORK_NO_FIXED_HOST
01-github-mcp-server/server.py, line 122
response = requests.get(
01-github-mcp-server/README.md, line 152
All GitHub HTTP calls are mocked (`unittest.mock.patch` on `server.requests.get`), so the test suite is deterministic, runs offline, and never requires `GITHUB_TOKEN`.
Secrets
Concern
reads a credential or environment file.
SECRETS_ENV_READ SECRETS_PATH_DOTENV
01-github-mcp-server/server.py, line 107
token = os.getenv("GITHUB_TOKEN")
01-github-mcp-server/README.md, line 22
Repeat for `client_demo.py`, `tests/test_server.py` (create the `tests/` folder first with `!mkdir -p tests`), `requirements.txt`, `.env.example`, and `.gitignore`.
01-github-mcp-server/README.md, line 88
├── .env.example
Show more
01-github-mcp-server/README.md, line 128
Copy `.env.example` to `.env` and fill in your token if you have one:
01-github-mcp-server/README.md, line 131
cp .env.example .env
01-github-mcp-server/README.md, line 136
**The code never contains a real token.** `.env` is git-ignored.
01-github-mcp-server/README.md, line 193
- **Never commit tokens.** `.env` is listed in `.gitignore`; `.env.example` ships with an empty value.
01-github-mcp-server/notebook/github_mcp_server_demo.ipynb, line 377
" └── .env.example\n",
01-github-mcp-server/notebook/github_mcp_server_demo.ipynb, line 436
" └── .env.example\n",
Agent instructions
Pass
No instruction to ignore earlier instructions or to hide a step.
Obfuscation
Pass
No encoded or minified payload found.
Licence
Pass
A licence file is present (LICENSE).
Maintainer activity
Pass
The latest commit is within the last 365 days.
Note
Hygiene check of commit 53b0b0f034ac. can reach a host that is not written as a fixed address. reads a credential or environment file.
Date and source
Date checked:
github.com
Commit graded: 53b0b0f034ac9e149a1e31abb0e4b9b870951bd6
This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.