MCP, MCP server
io.github.RayAKaan/ocular-audio-mcp
Universal local-first media intelligence for AI agents.
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.
Rescanned at commit b856c6d12752, unchanged since the check below.
PERMISSION_DELETE_FILES INSTALL_UNPINNED NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV SECRETS_ENV_READ
Why this grade
- PERMISSION_DELETE_FILES Low
Contains a call that can delete files.
media_resolver.py, line 230
result = subprocess.run( - INSTALL_UNPINNED Low
Dependencies use a range or git URL with no lockfile.
requirements.txt, line 1
mcp>=2.0.0,<3 - NETWORK_NO_FIXED_HOST Low
Makes a network call whose host is not written as a fixed address.
ocular_audio_mcp.py, line 893
return api.fetch(video_id) - SECRETS_PATH_DOTENV Low
Mentions a .env file.
README.md, line 179
cp .env.example .env - SECRETS_ENV_READ Note
Reads an environment variable whose name contains KEY, SECRET, TOKEN, PASSWORD or CREDENTIAL.
deployment_security.py, line 61
token = os.getenv("OCULAR_AUDIO_MCP_AUTH_TOKEN", "").strip() or None
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
Concern
can delete files.
PERMISSION_DELETE_FILES
media_resolver.py, line 230
result = subprocess.run(
ocular_audio_mcp.py, line 225
result = subprocess.run(
ocular_audio_mcp.py, line 266
result = subprocess.run(
Show more
ocular_audio_mcp.py, line 279
result = subprocess.run(
ocular_audio_mcp.py, line 349
shutil.rmtree(frame_dir, ignore_errors=True)
ocular_audio_mcp.py, line 364
shutil.rmtree(frame_dir, ignore_errors=True)
ocular_audio_mcp.py, line 793
result = subprocess.run(
ocular_audio_mcp.py, line 834
os.remove(audio_file_path)
ocular_audio_mcp.py, line 2843
subprocess.run(['pbcopy'], input=text, text=True, check=True)
ocular_audio_mcp.py, line 2846
subprocess.run(['clip'], input=text, text=True, check=True)
ocular_audio_mcp.py, line 2850
subprocess.run(['xclip', '-selection', 'clipboard'], input=text, text=True, check=True)
bin/cli.js, line 73
fs.unlinkSync(path.join(CACHE_DIR, file));
Install and update
Concern
dependencies are not pinned.
INSTALL_UNPINNED
requirements.txt, line 1
mcp>=2.0.0,<3
Network
Concern
can reach a host that is not written as a fixed address.
NETWORK_NO_FIXED_HOST
ocular_audio_mcp.py, line 893
return api.fetch(video_id)
ocular_audio_mcp.py, line 2394
return api.fetch(video_id)
ocular_audio_mcp.py, line 3230
return api.fetch(video_id)
Show more
docker/docker-compose.yml, line 21
test: ["CMD", "python", "-c", "import socket; s=socket.create_connection(('127.0.0.1',8000),3); s.close()"]
Secrets
Concern
reads a credential or environment file.
SECRETS_ENV_READ SECRETS_PATH_DOTENV
deployment_security.py, line 61
token = os.getenv("OCULAR_AUDIO_MCP_AUTH_TOKEN", "").strip() or None
deployment_security.py, line 74
ttl_raw = os.getenv("OCULAR_AUDIO_MCP_TOKEN_TTL", "3600")
README.md, line 179
cp .env.example .env
Show more
.dockerignore, line 11
cookies.txt
.gitignore, line 3
node_modules/
RELEASE_v1.3.0.md, line 28
cp .env.example .env
docker/docker-compose.yml, line 9
- ../.env
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 b856c6d12752. can delete files. dependencies are not pinned. 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: b856c6d127522ac6697e346d1ea6a9580e8c6aad
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.