# Jay MCP
A demo MCP (Model Context Protocol) server with tools and resources for demonstration purposes.
## Features
- **Tools**: Mathematical operations and server information
- **Resources**: Personalized greetings and server documentation
- **Easy to use**: Simple command-line interface
- **Extensible**: Modular design for easy customization
## Installation
### Quick Install from PyPI
```bash
pip install jay-mcp
```
### MCP Client Installation (Recommended)
For MCP clients, use uvx for automatic latest version loading:
```bash
uvx install jay-mcp
```
### GitHub Token Configuration
Configure your GitHub token for higher API rate limits (5000/hour vs 60/hour):
```bash
# Method 1: Environment variable
export GITHUB_TOKEN="your_github_token_here"
# Method 2: .env file
echo "GITHUB_TOKEN=your_github_token_here" > .env
```
Get your token at: [GitHub Settings > Developer settings > Personal access tokens](https://github.com/settings/tokens)
### From Source
```bash
git clone https://github.com/your-username/jay-mcp.git
cd jay-mcp
pip install -e .
```
## Usage
### As an MCP Server
```bash
# Start the MCP server
python -m jay_mcp.cli
# Check version
python -m jay_mcp.cli --version
```
### MCP Client Configuration
Add to your MCP client configuration:
```json
{
"mcpServers": {
"jay-mcp": {
"command": "uvx",
"args": ["jay-mcp"],
"env": {
"GITHUB_TOKEN": "your_github_token_here"
}
}
}
}
```
### AI Usage Examples
Once configured, you can use these commands in your AI client:
- "获取 React 的 GitHub 仓库信息"
- "比较这些项目的 star 数：facebook/react, vuejs/vue"
- "查询 microsoft/vscode 的详细信息"
- "分析这些机器学习项目：tensorflow/tensorflow, pytorch/pytorch"
## Available Tools
- **batch_get_repo_info(repos)**: 批量获取GitHub仓库信息
- 参数: `repos` - 仓库列表，格式：["owner/repo", ...]
- 返回: 包含仓库详细信息的字典列表
- 功能: 并行查询多个GitHub仓库的基本信息（stars、forks、语言等）
- 限制: 单次最多查询50个仓库
## Available Resources
- **greeting://{name}**: Get a personalized greeting
- **info://server**: Get server information and documentation
## Development
### Setup Development Environment
```bash
git clone https://github.com/your-username/jay-mcp.git
cd jay-mcp
pip install -e ".[dev]"
```
### Running Tests
```bash
pytest
```
### Code Formatting
```bash
black jay_mcp/
isort jay_mcp/
```
### Type Checking
```bash
mypy jay_mcp/
```
## MCP Client Configuration
To use jay-mcp with an MCP client, add this configuration to your MCP settings:
```json
{
"mcpServers": {
"jay-mcp": {
"command": "uvx",
"args": ["jay-mcp@latest"],
"description": "Jay MCP Demo Server - Auto-updates to latest version"
}
}
}
```
The `@latest` tag ensures you always get the newest version automatically.
For a complete configuration example with tool and resource definitions, see [mcp_config.json](mcp_config.json).
## Advanced Configuration
You can also create a custom server instance programmatically:
```python
from jay_mcp.server import create_server
# Create a custom server
server = create_server("My Custom MCP Server")
```
## Contributing
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Run the test suite
6. Submit a pull request
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Changelog
### 0.1.0 (2025-07-14)
- Initial release
- Basic MCP server with tools and resources
- Command-line interface
- PyPI package support
Raw data
{
"_id": null,
"home_page": null,
"name": "jay-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "Jay MCP Team <contact@example.com>",
"keywords": "mcp, model-context-protocol, github, repository, batch, api, ai, tools",
"author": null,
"author_email": "Jay MCP Team <contact@example.com>",
"download_url": "https://files.pythonhosted.org/packages/08/fc/bfe54e026eb04f4d4a993f570b7899b32734fca5bacd1d9c155236057224/jay_mcp-0.2.1.tar.gz",
"platform": null,
"description": "# Jay MCP\r\n\r\nA demo MCP (Model Context Protocol) server with tools and resources for demonstration purposes.\r\n\r\n## Features\r\n\r\n- **Tools**: Mathematical operations and server information\r\n- **Resources**: Personalized greetings and server documentation\r\n- **Easy to use**: Simple command-line interface\r\n- **Extensible**: Modular design for easy customization\r\n\r\n## Installation\r\n\r\n### Quick Install from PyPI\r\n\r\n```bash\r\npip install jay-mcp\r\n```\r\n\r\n### MCP Client Installation (Recommended)\r\n\r\nFor MCP clients, use uvx for automatic latest version loading:\r\n\r\n```bash\r\nuvx install jay-mcp\r\n```\r\n\r\n### GitHub Token Configuration\r\n\r\nConfigure your GitHub token for higher API rate limits (5000/hour vs 60/hour):\r\n\r\n```bash\r\n# Method 1: Environment variable\r\nexport GITHUB_TOKEN=\"your_github_token_here\"\r\n\r\n# Method 2: .env file\r\necho \"GITHUB_TOKEN=your_github_token_here\" > .env\r\n```\r\n\r\nGet your token at: [GitHub Settings > Developer settings > Personal access tokens](https://github.com/settings/tokens)\r\n\r\n### From Source\r\n\r\n```bash\r\ngit clone https://github.com/your-username/jay-mcp.git\r\ncd jay-mcp\r\npip install -e .\r\n```\r\n\r\n## Usage\r\n\r\n### As an MCP Server\r\n\r\n```bash\r\n# Start the MCP server\r\npython -m jay_mcp.cli\r\n\r\n# Check version\r\npython -m jay_mcp.cli --version\r\n```\r\n\r\n### MCP Client Configuration\r\n\r\nAdd to your MCP client configuration:\r\n\r\n```json\r\n{\r\n \"mcpServers\": {\r\n \"jay-mcp\": {\r\n \"command\": \"uvx\",\r\n \"args\": [\"jay-mcp\"],\r\n \"env\": {\r\n \"GITHUB_TOKEN\": \"your_github_token_here\"\r\n }\r\n }\r\n }\r\n}\r\n```\r\n\r\n### AI Usage Examples\r\n\r\nOnce configured, you can use these commands in your AI client:\r\n\r\n- \"\u83b7\u53d6 React \u7684 GitHub \u4ed3\u5e93\u4fe1\u606f\"\r\n- \"\u6bd4\u8f83\u8fd9\u4e9b\u9879\u76ee\u7684 star \u6570\uff1afacebook/react, vuejs/vue\"\r\n- \"\u67e5\u8be2 microsoft/vscode \u7684\u8be6\u7ec6\u4fe1\u606f\"\r\n- \"\u5206\u6790\u8fd9\u4e9b\u673a\u5668\u5b66\u4e60\u9879\u76ee\uff1atensorflow/tensorflow, pytorch/pytorch\"\r\n\r\n## Available Tools\r\n\r\n- **batch_get_repo_info(repos)**: \u6279\u91cf\u83b7\u53d6GitHub\u4ed3\u5e93\u4fe1\u606f\r\n - \u53c2\u6570: `repos` - \u4ed3\u5e93\u5217\u8868\uff0c\u683c\u5f0f\uff1a[\"owner/repo\", ...]\r\n - \u8fd4\u56de: \u5305\u542b\u4ed3\u5e93\u8be6\u7ec6\u4fe1\u606f\u7684\u5b57\u5178\u5217\u8868\r\n - \u529f\u80fd: \u5e76\u884c\u67e5\u8be2\u591a\u4e2aGitHub\u4ed3\u5e93\u7684\u57fa\u672c\u4fe1\u606f\uff08stars\u3001forks\u3001\u8bed\u8a00\u7b49\uff09\r\n - \u9650\u5236: \u5355\u6b21\u6700\u591a\u67e5\u8be250\u4e2a\u4ed3\u5e93\r\n\r\n## Available Resources\r\n\r\n- **greeting://{name}**: Get a personalized greeting\r\n- **info://server**: Get server information and documentation\r\n\r\n## Development\r\n\r\n### Setup Development Environment\r\n\r\n```bash\r\ngit clone https://github.com/your-username/jay-mcp.git\r\ncd jay-mcp\r\npip install -e \".[dev]\"\r\n```\r\n\r\n### Running Tests\r\n\r\n```bash\r\npytest\r\n```\r\n\r\n### Code Formatting\r\n\r\n```bash\r\nblack jay_mcp/\r\nisort jay_mcp/\r\n```\r\n\r\n### Type Checking\r\n\r\n```bash\r\nmypy jay_mcp/\r\n```\r\n\r\n## MCP Client Configuration\r\n\r\nTo use jay-mcp with an MCP client, add this configuration to your MCP settings:\r\n\r\n```json\r\n{\r\n \"mcpServers\": {\r\n \"jay-mcp\": {\r\n \"command\": \"uvx\",\r\n \"args\": [\"jay-mcp@latest\"],\r\n \"description\": \"Jay MCP Demo Server - Auto-updates to latest version\"\r\n }\r\n }\r\n}\r\n```\r\n\r\nThe `@latest` tag ensures you always get the newest version automatically.\r\n\r\nFor a complete configuration example with tool and resource definitions, see [mcp_config.json](mcp_config.json).\r\n\r\n## Advanced Configuration\r\n\r\nYou can also create a custom server instance programmatically:\r\n\r\n```python\r\nfrom jay_mcp.server import create_server\r\n\r\n# Create a custom server\r\nserver = create_server(\"My Custom MCP Server\")\r\n```\r\n\r\n## Contributing\r\n\r\n1. Fork the repository\r\n2. Create a feature branch\r\n3. Make your changes\r\n4. Add tests if applicable\r\n5. Run the test suite\r\n6. Submit a pull request\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n\r\n## Changelog\r\n\r\n### 0.1.0 (2025-07-14)\r\n\r\n- Initial release\r\n- Basic MCP server with tools and resources\r\n- Command-line interface\r\n- PyPI package support\r\n",
"bugtrack_url": null,
"license": null,
"summary": "MCP server for batch GitHub repository information retrieval with parallel processing",
"version": "0.2.1",
"project_urls": {
"Bug Tracker": "https://github.com/your-username/jay-mcp/issues",
"Documentation": "https://github.com/your-username/jay-mcp#readme",
"Homepage": "https://github.com/your-username/jay-mcp",
"Repository": "https://github.com/your-username/jay-mcp"
},
"split_keywords": [
"mcp",
" model-context-protocol",
" github",
" repository",
" batch",
" api",
" ai",
" tools"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "640a349caa96e85385c8a78f974394cd8d579ef6eaae28aef700eadebcccce67",
"md5": "b4a99e85d75f70e325914bb31e6f88f2",
"sha256": "f5f9f4f6ca5d12987f9e0b9f00e037f6776c1de1d183158a1dc8ba3b9d749b31"
},
"downloads": -1,
"filename": "jay_mcp-0.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b4a99e85d75f70e325914bb31e6f88f2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 15935,
"upload_time": "2025-07-14T08:14:21",
"upload_time_iso_8601": "2025-07-14T08:14:21.001327Z",
"url": "https://files.pythonhosted.org/packages/64/0a/349caa96e85385c8a78f974394cd8d579ef6eaae28aef700eadebcccce67/jay_mcp-0.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "08fcbfe54e026eb04f4d4a993f570b7899b32734fca5bacd1d9c155236057224",
"md5": "33473f4e7a368c64ff34630d01f4ce19",
"sha256": "43758a86551cf0d5f1214b724844a50138c6fd1d56f5244b2a70c86e8a7cca4f"
},
"downloads": -1,
"filename": "jay_mcp-0.2.1.tar.gz",
"has_sig": false,
"md5_digest": "33473f4e7a368c64ff34630d01f4ce19",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 14349,
"upload_time": "2025-07-14T08:14:22",
"upload_time_iso_8601": "2025-07-14T08:14:22.259648Z",
"url": "https://files.pythonhosted.org/packages/08/fc/bfe54e026eb04f4d4a993f570b7899b32734fca5bacd1d9c155236057224/jay_mcp-0.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-14 08:14:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "your-username",
"github_project": "jay-mcp",
"github_not_found": true,
"lcname": "jay-mcp"
}
JSON
