mcp-server
About
A Model Context Protocol (MCP) server that integrates jina.ai tools (search, web page reading) and serves as a learning project for writing MCP servers. It is designed for use with AI assistants like Claude.
Details
- Author
- yiGmMk
- GitHub stars
- 5
- Downloads
- 211
- Categories
- Other
Jump to
- Integrates jina.ai tools for search and web page reading.
- Requires Python 3.12 or newer and the uv package manager.
- Configurable via standard MCP JSON settings.
- Supports manual and Smithery-based automatic installation.
- Environment variables for API key management.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
mcp-serverCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install Python 3.12+ and the uv package manager. Then configure the server in your MCP client (e.g., Claude Desktop) using the provided mcpServers JSON block, setting the command to uv with arguments pointing to your local main.py file and providing the required API keys (JINA_API_KEY, GOOGLE_AI_STUDIO_KEY). Automatic installation via Smithery is also available.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp-server": {
"mcp-server-yigmmk": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@yiGmMk/mcp-server",
"--client",
"claude"
]
}
}
}
}McpServers
{
"mcp-server-yigmmk": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@yiGmMk/mcp-server",
"--client",
"claude"
]
}
}mcp-server
学习写 mcp server
安装 (cline)
Installing via Smithery
To install mcp-server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @yiGmMk/mcp-server --client claude
前置依赖
• Python 3.12 or newer
• uv package manager
没有安装uv的,请参考文档uv 安装文档
macos或linux可使用如下命令安装
curl -LsSf https://astral.sh/uv/install.sh | sh
windwos,在powershell下安装
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
配置文件
优先使用下面这种配置方式
{
"mcpServers": {
"yiGmMk/mcp-server": {
"command": "uv",
"args": [
"--directory",
"/path/to/your/mcp-server",
"run",
"main.py"
],
"env": {
"JINA_API_KEY": "jina_api_key,请从https://jina.ai/reader获取",
"GOOGLE_AI_STUDIO_KEY": "Google AI Studio api key,请从https://aistudio.google.com/apikey获取",
"PYTHONIOENCODING": "utf-8"
},
"disabled": false,
"autoApprove": []
}
}
}
或使用venv(增加环境变量配置)
{
"mcpServers": {
"yiGmMk/mcp-server": {
"command": "uv",
"args": [
"run",
"/path/to/your/mcp-server/main.py"
],
"env": {
"VIRTUAL_ENV": "/path/to/your/mcp-server/.venv",
"JINA_API_KEY": "jina_api_key,请从https://jina.ai/reader获取",
"GOOGLE_AI_STUDIO_KEY": "Google AI Studio api key,请从https://aistudio.google.com/apikey获取",
"PYTHONIOENCODING": "utf-8"
},
"disabled": false,
"autoApprove": []
}
}
}
jina.ai
jina.ai提供的各种工具,如搜索,读取网页...
TODO
- [ ] 发布到 https://smithery.ai/server/@yiGmMk/mcp-server/tools
dockerfile构建成功,但是mcp服务在docker中运行后立即退出,导致无法使用,相关issue:
1.MCP within a Docker Container exits, regardless of lifespan
2. ifespan shuts as soon as it opens
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
